Troubleshooting
Shopify CSV import errors, explained
Invalid CSV header
Invalid CSV header: missing headers
Shopify read the first line of your file and didn't find the header row its product importer expects.
Causes and fixHandle already exists
Ignored line #-## because handle `example` already exists
Two different products in your file have the same handle. A handle identifies one product, so Shopify ignored the lines that would have created a second product with it.
Causes and fixLine did not contain product data
Ignored line #-## because it did not contain product data
The line has a handle but no title, so Shopify can't create a product from it.
Causes and fixIllegal quoting or stray quote
Illegal quoting on line … / Missing or stray quote on line …
Shopify couldn't read part of the file because of a quote mark that doesn't open or close properly, or a character the importer can't read.
Causes and fixOptions are not unique
Validation failed: options are not unique
Two variants of the same product have exactly the same option values (two rows that are both Size M, Colour Blue), so Shopify can't tell them apart.
Causes and fixImage failed to download
Validation failed: An error occurred while trying to download the image
Shopify tried to download the image at the link in your file and couldn't. A similar error, “getaddrinfo: nodename nor servname provided, or not known”, means the link itself is wrong.
Causes and fixPrice can't be blank
Validation failed: price can't be blank
A variant row has no price. Every variant Shopify creates needs one.
Causes and fixValue must be a valid product reference
Validation failed: Value must be a valid product reference
A metafield in your file points to a product that doesn't exist in the store yet, or the value isn't a product reference at all.
Causes and fixSrc can't be blank
Validation failed: Src can't be blank
A row describes an image, with alt text or a position, but has no image link in Image Src, so Shopify has nothing to attach that description to.
Causes and fixCSV encoding (UTF-8) errors
Strange characters such as é, ’ or � after a CSV import
Shopify reads every CSV file as UTF-8. A file saved in another encoding has its accented letters, curly quotes and symbols read as the wrong characters.
Causes and fixInventory quantity errors
Inventory quantity is not a number / Inventory quantity can't be blank
A stock cell has something other than a whole number, or it's empty while the variant tracks inventory.
Causes and fix
Bulkvane's messages, A–ZShopify CSV import not working? 11 causesFree CSV templates
Preview every change.Undo any import for 30 days.
Install free