Shopify product CSV images: hosted URLs and import expectations
Shopify’s product CSV references images by URL, not by embedding binary data in the sheet. Each URL must resolve over HTTPS for customers and importers—typically as a direct image response, not an HTML page that happens to contain an image. When URLs require cookies, redirect infinitely, or point at expired signed links, rows import while media fails or disappears on the next sync.
Column names and behavior follow the product CSV specification in Using CSV files to import and export products. Cross-check your header against a fresh export before debugging CDN issues.
Public accessibility beats “works in my browser”
A URL that opens logged into your Dropbox or internal DAM is not a public asset for Shopify’s fetcher. Host final assets on a stable CDN, Shopify Files when appropriate, or another store with predictable caching headers.
Multiple images per row
Shopify uses additional image columns (Image Src, Image Position, Alt Text patterns per docs). Follow the exact naming from your export rather than inventing shortened headers. Position values control gallery order; inconsistent positions produce confusing storefront galleries even when all files download.
Hotlink protection and bot blockers
Some hosts block non-browser user agents. Shopify’s fetch may be denied while manual Chrome tests succeed. Whitelist Shopify fetchers per your host’s documentation or move assets to Shopify-managed storage for imports you control end-to-end.
Signed URLs with short TTL
Temporary signed URLs expire. If marketing recycles an old CSV months later, images break even though the import once succeeded. Long-lived URLs or importer refresh jobs are the operational fix.
Silent failures tied to media
When products exist but images are wrong, compare the post-import export’s image columns against your source file. Walk the troubleshooting sequence in silent failure.
LaunchCSV note
LaunchCSV can stage uploads that become URLs suitable for embedding; retention and hosting details are still subject to your checkout and storage policy—see site Privacy and Terms. The architectural point remains: CSV carries strings, not the image bytes themselves.
FAQ
Can I reference localhost URLs?
No. Shopify’s servers cannot fetch your laptop.
Do image file names need to match SKUs?
Not unless your internal convention requires it—Shopify keys off the URL content, not the filename, unless you build custom automation.
What about videos or 3D models?
They use different mechanisms than classic product image columns—consult current Shopify Help for media types outside standard CSV image fields before promising timelines.