Bulk Generation
What is Bulk Generation?
Bulk generation lets you create many asset variations automatically by combining a template with data from a spreadsheet. Instead of manually editing each variation, you import a CSV or Excel file and generate all assets at once.
Use Cases
- Personalized marketing materials with names and details
- Event badges for multiple attendees
- Social media posts for different products
- Localized assets in multiple languages
- Team member profiles with individual photos
Preparing Your Data
Spreadsheet Format
Your spreadsheet should have column headers that match the template field names:
| headline | subtext | background_color | image_url |
|---|---|---|---|
| Summer Sale | 50% Off Everything | #ff6b6b | summer.jpg |
| New Arrivals | Shop the Collection | #4ecdc4 | arrivals.jpg |
| Flash Deal | Today Only | #ffe66d | flash.jpg |
Supported Formats
- CSV - Comma-separated values (.csv)
- Excel - Microsoft Excel files (.xlsx, .xls)
- Google Sheets - Export as CSV or copy-paste
Column Mapping
Column headers are automatically matched to template fields by name. If names don't match exactly, you can manually map columns to fields during import.
Step-by-Step Process
Select a Template
Choose a template from the Template Browser. Note which fields are available - these will be the columns you need in your spreadsheet.
Click Bulk Generate
In the Editor Panel, click the "Bulk Generate" button to open the import dialog.
Upload Your Spreadsheet
Drag and drop your CSV or Excel file, or click to browse. The system validates your data and shows a preview.
Map Columns to Fields
Review the automatic column mapping. Adjust any mismatched columns by selecting the correct field from the dropdown.
Preview and Generate
Preview a few variations to ensure they look correct. Click "Generate All" to create all variations.
Export Results
Once generated, browse through variations or export all as a ZIP archive with your chosen format and settings.
Working with Images
Image References
For image fields, you can use:
- URLs - Full web URLs to images (https://...)
- File names - Names of uploaded images
- Placeholder - Leave empty to use template default
Uploading Bulk Images
- Before importing data, click "Upload Images" in the bulk dialog
- Select multiple image files at once
- Images are uploaded and available by filename
- Reference them in your spreadsheet by filename
Data Validation
The system validates your data before generation:
- Required fields - Ensures essential fields have values
- Color formats - Validates hex codes (#ffffff) or color names
- Image existence - Checks that referenced images exist
- Text length - Warns if text exceeds recommended length
Note
Rows with validation errors are highlighted. You can choose to skip invalid rows or fix them before generating.
Limits and Performance
| Metric | Limit |
|---|---|
| Maximum rows per batch | 500 variations |
| Maximum file size (CSV) | 5 MB |
| Maximum images per batch | 100 images |
| Image file size limit | 10 MB each |
Tips for Best Results
- Test with small batches - Start with 5-10 rows to verify mapping
- Use consistent data - Keep text lengths similar across rows
- Prepare images beforehand - Upload all images before importing data
- Check previews - Review several variations before full generation
- Use Focused mode - Bulk generation requires Focused editing mode
Exporting Bulk Results
After generation, you can:
- Browse variations - Click through to review each one
- Edit individual items - Make manual adjustments to specific variations
- Export selected - Choose specific variations to export
- Export all - Download all variations as a ZIP file
Export Naming
Bulk exports use a naming pattern you can customize:
{template}-{row}- Template name + row number{column_name}- Use a column value in the filename
Example: badge-{name} produces badge-john-smith.png