Understand artwork, sheet, sidecar, and Voice Trainer limits
Artwork uploads accept TIF, TIFF, PNG, JPG, and JPEG. One upload request is limited to 3 GiB total and 200 files, and each artwork file is limited to 2 GiB. Review the separate limits for sidecars, copy sheets, settings restore, and Voice Trainer.
- Availability
- Live
- Last verified
What this does
Artwork uploads accept TIF, TIFF, PNG, JPG, and JPEG. One upload request is limited to 3 GiB total and 200 files, and each artwork file is limited to 2 GiB. Review the separate limits for sidecars, copy sheets, settings restore, and Voice Trainer.
Before you begin
- Keep the original artwork and a backup outside ArtDrop.
- Use TIF or TIFF, PNG, JPG, or JPEG for artwork. Check any deployment guard and the current storage and provider requirements before upload.
- In a CSV or XLSX sheet, put the artwork filename or stem in the filename column. A JSON sidecar's basename must match the artwork stem.
What changes outside ArtDrop
Reading this guide changes nothing. Upload admission checks the sanitized filename and supported extension, plus the 2 MiB cap for sheets and sidecars. It does not validate artwork readability or dimensions. Accepted artwork then follows the resolved route and its downstream limits.
Steps
-
Use a supported artwork file
Upload TIF or TIFF, PNG, JPG, or JPEG. Confirm that the file opens and contains enough real pixels for the intended product.
-
Use CSV or XLSX copy sheets.
Each CSV or XLSX copy sheet is limited to 2 MiB at upload. ArtDrop matches rows by filename or stem and scans sheets in the incoming queue.
-
Keep sidecars focused
Each JSON sidecar is limited to 2 MiB at upload. Use it for per-image copy and routing, not credentials, tokens, or embedded artwork.
-
Use supported Voice Trainer samples
Voice Trainer accepts up to 10 files per request. Supported formats are DOCX, PDF, TXT, CSV, JPG, JPEG, and PNG, with no per-file byte cap defined by that endpoint.
-
Understand how storage is resolved
Verify one controlled artwork with the storage service and provider selected for this route before sending a batch.
-
Treat clipboard resolution as supplied
A pasted image uses the pixels and color data supplied by the source app. Upload the original master when exact resolution, transparency, or profile matters.
Expected result
The artwork, sheet, and sidecar pass admission. One controlled upload and provider fetch verify the storage route that actually succeeded before you send a batch.
Good to know
- One upload request is limited to 3 GiB total and 200 files. Each artwork file is limited to 2 GiB. Downstream services can set lower limits.
- CSV and XLSX copy sheets are supported. Each sheet and each JSON sidecar is limited to 2 MiB at upload; no row or per-cell cap is defined in the sheet parser.
- Voice Trainer accepts up to 10 DOCX, PDF, TXT, CSV, JPG, JPEG, or PNG files per request and defines no per-file byte cap.
- Provider product dimensions and DPI guidance are separate from upload acceptance.
- A supported extension does not prove the file is readable or large enough for the print.
- A pasted preview can be smaller or flatter than the original file.
- ArtDrop has no separate live fabric-repeat preview or repeat-render request limit.
- A browser upload makes up to three total attempts for transient or safely replayable failures.
- ArtDrop scans admitted CSV and XLSX copy sheets in the incoming queue.
- One upload request is limited to 3 GiB total and 200 files. Each artwork file is limited to 2 GiB.
- Use CSV or XLSX copy sheets.
- Each CSV or XLSX copy sheet is limited to 2 MiB. ArtDrop does not currently set a row-count or per-cell character limit.
- Voice Trainer accepts up to 10 files per request: DOCX, TXT, PDF, CSV, JPG, JPEG, and PNG. ArtDrop does not currently set a per-file byte limit for these samples. Combined extracted text is limited to 120,000 characters.
Troubleshooting
- Browser upload still failed after its bounded attempts, or reported an outcome-unknown timeout? Check whether the file reached Accepted, the queue, or an external result. Retry one file manually only when no existing work or result is present.
- Storage upload failed or used an unexpected route? The UI directly tests B2 and the Shopify connection, not R2, Dropbox, Google Drive, or Shopify Files storage. Save the required credentials, remove unused higher-priority credentials, and verify one controlled file.
- Sheet rejected? Check its size, supported format, headers, and literal filenames.
- Sidecar rejected? Validate UTF-8 JSON and the matching filename stem.
- Pasted image is soft? Upload the original master.
How to undo or clean up
Remove rejected files and correct them before resubmitting. If processing already created external records, clean them up in the provider, storefront, or storage service that owns them.