“Ignored line because handle already exists”: fixing duplicate handles

What the message means

The URL handle identifies a product and becomes its web address, so it must be unique. Shopify’s help center describes the cause as duplicate product handles in the CSV. When a later row for that handle starts a new product with its own title, Shopify doesn’t merge the two, and those lines are ignored.

Common causes

• Handles built from short titles: “Cotton Throw Natural” and “Cotton Throw Graphite” both became cotton-throw.
• The same product appears twice in the supplier list, with different titles or prices.
• The product is already in your store and you imported without “Overwrite products with matching handles”.
• Variants written as separate products, each with a title, instead of as variant rows.

How to fix it

1. Search the file for the handle named in the message.
2. If the rows are variants of one product, keep the title only on the first row and put the differences in option columns (see the variants guide).
3. If they are different products, give each a unique handle, for example by adding the color or the SKU: cotton-throw-natural.
4. If the product already exists in your store and you meant to update it, import with Overwrite products with matching handles checked. Remember that empty columns overwrite existing values.
5. Import again.

Prevent it next time

Generate handles from something unique, such as the title plus the parent SKU. Sheet2Store creates each handle from the product group plus a short unique code, so two products never collide, and it flags duplicate variant combinations in the review table before you export.