Skip to content

NewSchedule your Black Friday sale: prices drop at the start and go back by themselves. See how

Bulkvane

Troubleshooting

Shopify CSV import errors, explained

The messages Shopify's product importer shows most often, what each one means, and how to fix your file. Looking for a message Bulkvane showed you? See Errors A–Z in the help center.
  • 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 fix
  • Handle 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 fix
  • Line 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 fix
  • Illegal 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 fix
  • Options 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 fix
  • Image 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 fix
  • Price 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 fix
  • Value 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 fix
  • Src 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 fix
  • CSV 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 fix
  • Inventory 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