Batch Export
Generate hundreds or thousands of QR codes at once from a CSV file. Perfect for events, inventory, product catalogs, and marketing campaigns.
What is Batch Export?
Batch Export allows you to:
- Generate multiple QR codes from a single CSV file
- Apply custom frames and text to each QR code
- Use different data for each code (URLs, vCards, text, etc.)
- Customize filenames for each exported image
- Export all codes in one ZIP file
- Apply same encryption password to all codes (optional)
Quick Start
- Prepare a CSV file with your data
- Click Create tab → Batch Export button
- Upload your CSV file
- Preview and adjust settings
- Click Export All as PNG/JPG/SVG
- Download ZIP file with all QR codes
CSV File Format
Basic Structure
The CSV file must have a header row with column names:
data
https://example.com/product1
https://example.com/product2
https://example.com/product3
Available Columns
| Column Name | Required | Description | Example |
|---|---|---|---|
data | ✅ Yes | URL or text data | https://example.com |
frametext | No | Custom frame text | Product ABC |
filename | No | Custom export filename | product-abc |
fontfamily | No | Frame text font | Arial |
Example CSV Files
Simple URLs
data
https://scottsdalemint.com
https://dealers.scottsdalemint.com
https://qr-generator.scottsdalemint.com
URLs with Frame Text
data,frametext
https://scottsdalemint.com,Retail Store
https://dealers.scottsdalemint.com,Dealer Portal
https://qr-generator.scottsdalemint.com,QR Generator
Complete Example with All Fields
data,frametext,filename,fontfamily
https://example.com/product-001,Gold Bar 1oz,gold-bar-1oz,Roboto
https://example.com/product-002,Silver Coin,silver-coin,Roboto
https://example.com/product-003,Platinum Round,platinum-round,Arial
vCard Batch (Business Cards)
firstname,lastname,org,position,phonework,email,website,address,city,state,country,postalcode,frametext,filename
John,Doe,Scottsdale Mint,CEO,555-0100,[email protected],scottsdalemint.com,123 Main St,Scottsdale,AZ,USA,85251,John Doe CEO,john-doe
Jane,Smith,Scottsdale Mint,CFO,555-0101,[email protected],scottsdalemint.com,123 Main St,Scottsdale,AZ,USA,85251,Jane Smith CFO,jane-smith
Creating Your CSV File
Using Microsoft Excel
- Open Excel
- Enter column headers in first row (
data,frametext,filename) - Enter your data in rows below
- File → Save As → Choose CSV (Comma delimited) (*.csv)
- Click Save
Using Google Sheets
- Open Google Sheets
- Enter column headers and data
- File → Download → Comma Separated Values (.csv)
- Upload to QR Generator
Using Text Editor
Create a file with .csv extension:
data,frametext
https://example.com,Product 1
https://example.com,Product 2
Important: Use commas (,) as separators, not semicolons or tabs.
Template Files
Pre-made CSV templates are available in the app:
| Template | Description | Use Case |
|---|---|---|
| Simple Batch | 2 URL columns | Basic URL list |
| With Frame Text | 6 URLs + frames | Product labels |
| vCard Sample | Contact cards | Business cards, badges |
| Multi-line Frame | Complex frames | Events, detailed info |
| With Filenames | Custom naming | Organized exports |
Download templates:
- Click Batch Export
- Click Example CSV dropdown
- Choose a template
- Click to download
- Edit in Excel/Google Sheets
- Upload back to generator
Batch Export Process
Step 1: Upload CSV
- Click Create tab
- Click Batch Export button
- Click Upload CSV or drag-and-drop file
- App validates your CSV structure
Step 2: Preview
After upload, you'll see:
- ✅ Total rows detected: Number of QR codes to generate
- 📊 Preview: First row's QR code preview
- ⚠️ Validation errors: Missing columns or invalid data
Preview Controls:
- Use ◀️ ▶️ arrows to preview different rows
- Current row number shows (e.g., "1 / 100")
- QR code updates live as you navigate
Step 3: Configure Settings
Adjust global settings that apply to all QR codes:
Style Settings:
- Preset selection
- Dot colors and shapes
- Corner styles
- Background color
Frame Settings (if CSV has frametext column):
- Enable/disable frames
- Frame position (top, bottom, left, right)
- Frame colors and styling
- Font family (if specified in CSV)
Encryption (optional):
- Enable encryption
- Enter password (same for all codes)
Error Correction:
- Choose level (L, M, Q, H)
- Higher = more reliable but larger
Step 4: Export
- Choose format: PNG, JPG, or SVG
- Click Export All as [format]
- Progress bar shows: "Creating QR codes... 5 / 100"
- When complete, ZIP file auto-downloads
Step 5: Extract ZIP
- Locate downloaded
qr-codes.zip - Extract/unzip the file
- Find all your QR code images inside
Filename Generation
The app generates filenames automatically using this priority:
Priority Order
filenamecolumn (if provided) — Highest priorityframetextcolumn (if no filename) — Second prioritydatacolumn (if neither above) — Auto-generated from data- Fallback —
qr-code-{index}if all else fails
Examples
data,frametext,filename
https://example.com,Product A,custom-name-a
https://example.com,Product B,
https://example.com,,
Results in:
custom-name-a.png(fromfilenamecolumn)product-b.png(fromframetext, sanitized)example-com.png(fromdata, sanitized)
Filename Sanitization
Special characters are replaced:
- Spaces → underscores
- Special chars (
/,\,:,*,?,",<,>,|) → removed - Lowercase conversion
- Max 255 characters
Example:
- Input:
Product #1 (Special!) - Output:
product_1_special.png
Advanced Features
Encrypted Batch Export
Generate encrypted QR codes in bulk:
- Upload CSV file
- Enable Encrypt QR code in settings
- Enter one password (applies to all)
- Export as usual
Use case: Conference badges with encrypted contact info
- All badges use same password
- Share password with staff only
- Public can't read attendee details
Custom Fonts
Specify fonts for frame text:
data,frametext,fontfamily
https://example.com,Bold Title,Roboto Bold
https://example.com,Elegant Text,Playfair Display
https://example.com,Modern Sans,Inter
Available fonts:
- System fonts (Arial, Times New Roman, etc.)
- Google Fonts (loads automatically)
- Custom uploaded fonts (if configured)
Variable Frame Positions
While not in CSV, you can set frame position globally:
- Top (default for horizontal text)
- Bottom
- Left (for vertical text)
- Right (for vertical text)
All QR codes in batch use same frame position.
Performance & Limits
Processing Speed
| Batch Size | Estimated Time | Notes |
|---|---|---|
| 1-50 codes | 5-15 seconds | Very fast |
| 51-200 codes | 30-60 seconds | Medium |
| 201-500 codes | 2-3 minutes | Slower, shows progress |
| 501-1000 codes | 5-8 minutes | May need tab to stay open |
| 1000+ codes | 10+ minutes | Keep tab open, don't navigate away |
Tips for large batches:
- Keep browser tab open and active
- Don't navigate away during export
- Close other tabs to free memory
- Use faster export format (SVG < PNG < JPG)
Recommended Limits
- Maximum rows: 10,000 (technical limit)
- Practical maximum: 1,000-2,000 rows
- Optimal batch size: 100-500 rows
For larger needs, split into multiple CSV files.
Common Use Cases
Product Labels (E-commerce)
data,frametext,filename
https://store.com/product/gold-bar-1oz,1 oz Gold Bar - #GB001,gb001
https://store.com/product/silver-coin-eagle,1 oz Silver Eagle - #SE001,se001
https://store.com/product/platinum-round,1 oz Platinum Round - #PR001,pr001
Result: Product labels with QR codes linking to product pages
Event Badges
firstname,lastname,org,position,email,frametext,filename
John,Doe,Acme Corp,CEO,[email protected],John Doe - CEO,badge-john-doe
Jane,Smith,Tech Inc,CTO,[email protected],Jane Smith - CTO,badge-jane-smith
Result: Attendee badges with encrypted vCard QR codes
Marketing Campaign
data,frametext
https://campaign.com?utm_source=qr&utm_campaign=spring,Spring Sale 2024
https://campaign.com?utm_source=qr&utm_campaign=summer,Summer Promo
https://campaign.com?utm_source=qr&utm_campaign=fall,Fall Discount
Result: Trackable QR codes for different campaigns
Inventory Management
data,frametext,filename
INV-2024-001,Gold Bar Storage A1,inv-001
INV-2024-002,Silver Coins Storage B2,inv-002
INV-2024-003,Platinum Rounds Storage C3,inv-003
Result: Internal inventory tracking labels
Troubleshooting
CSV Upload Fails
Error: "Invalid CSV format"
- Ensure file is saved as
.csv(not.xlsxor.xls) - Check for comma separators (not semicolons)
- Verify header row exists
- Remove any empty rows at bottom
Error: "Missing required columns"
- CSV must have
datacolumn - For vCards, must have
firstnameandlastname - Check spelling of column names (case-sensitive)
Export Stops/Fails
Browser freezes during export
- Reduce batch size (try 100 rows first)
- Close other browser tabs
- Use faster computer if available
- Try SVG format (fastest)
ZIP file not downloading
- Check browser download settings
- Disable popup blockers
- Check disk space
- Try different browser
QR Codes Look Wrong
All QR codes are identical
- Check CSV has different data in each row
- Verify
datacolumn has unique values - Review preview before exporting
Frame text missing
- Ensure CSV has
frametextcolumn - Check frame is enabled in settings
- Verify column name spelling
Filenames are generic
- Add
filenamecolumn to CSV - Or use
frametextfor auto-naming - Check filename priority order
Best Practices
- Test First — Upload CSV with 5-10 rows to test
- Preview All — Use arrows to check multiple rows before export
- Use Filenames — Add
filenamecolumn for organized exports - Split Large Batches — Keep under 500 rows for reliability
- Keep Originals — Save CSV file for future re-generation
- Version Control — Include date in filename:
qr-batch-2024-06-03.csv - Document Passwords — If encrypted, note password in secure location
- Test Scanning — Scan a few codes after printing to verify