Skip to content

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

Bulkvane

Shopify CSV import error

“Ignored line #-## because handle `example` already exists”: what it means and how to fix it

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.

Why it happens

  • Two products have the same title, so they were given the same handle.
  • Rows were copied and pasted, and the handle wasn't changed.
  • A product's variant rows were separated by sorting, so Shopify read them as another product.

How to fix it

  1. Find the handle from the message in your file.
  2. If the rows are variants of one product, keep them together, one under the other, and put the product's details on the first row only.
  3. If they're different products, give one of them a new handle using lowercase letters, numbers and dashes, such as linen-shirt-blue.
  4. To update the existing product instead of creating one, tick “Overwrite products with matching handles” when you import.

How Bulkvane handles it

In Bulkvane, rows that share a Handle are one product's variants by design. If they disagree on a product field, the check warns before anything changes, for example “Row 5: Title is different from row 3 of the same product. We'll use row 3.” So a clash between two products shows up in the preview. Handles with spaces or capitals are cleaned up for you: “Blue Shirt” becomes “blue-shirt”.

Every file is checked before anything changes, with problems named by row in plain words, and any import can be undone for 30 days. All of Bulkvane's messages are in Errors A–Z.

Questions

What is a product handle in Shopify?

The part of the product's URL after /products/, such as linen-shirt. It's unique for each product, and every variant row of a product repeats it.

Can I change a handle with a CSV?

In Shopify's importer, a different handle means a different product. In Bulkvane, a new Handle on a row with the product's ID changes the handle and redirects the old URL; Undo restores it.

Message, cause and fix from the Shopify Help Center: common product CSV import issues, checked . Still stuck? See Shopify CSV import not working? or ask us.

Preview every change.Undo any import for 30 days.

Install free