Bulk CSV upload failed
If a bulk CSV upload failed, start with the QRSurge template for the QR type you selected. Keep the header row unchanged, fix any preview errors, then upload the corrected .csv file again.
Use the matching template
Each bulk QR type uses its own CSV columns. A Website CSV is different from a vCard CSV, and a Location CSV is different from an Email CSV.
Download the template that matches the selected QR type:
- Website CSV template
- vCard CSV template
- Plain text CSV template
- Email CSV template
- SMS CSV template
- Phone CSV template
- Location CSV template
Do not rename the header row.
Fix required values
Columns ending in _required must be filled in for each row. Empty required cells will cause that row to fail validation.
Common required-value issues include:
- Missing website URL.
- Missing first name for vCard rows.
- Missing phone number for phone or SMS rows.
- Missing latitude or longitude for location rows.
- Missing plain text content.
Check value formatting
Bulk upload can also fail when a value does not match the expected format.
Check for:
- Website URLs that do not start with
https://orhttp://. - Invalid email addresses.
- Phone numbers without country codes.
- Latitude outside
-90to90. - Longitude outside
-180to180. - Text with commas that is not wrapped in quotes.
- Blank rows at the end of the file.
Save the file as .csv before uploading again.
Review dynamic settings and row capacity
Some bulk QR types can be dynamic, and others are static.
These bulk QR types can be dynamic:
- Website
- vCard
- SMS
- Phone
Plain text and Location bulk QR codes are static-only.
Bulk row capacity is plan-based. If the upload exceeds your current capacity, check pricing for current plan details or reduce the batch size.
Use the preview before creating
The upload preview shows valid rows and error rows before QRSurge creates the batch. Fix the CSV file, save it, and upload it again until the preview is ready.
Create a small test batch first when you are preparing a large print or product run.