How to Fix Duplicate Handle Errors in Shopify

A duplicate handle in Shopify means two products are trying to use the same URL handle, which Shopify doesn’t allow. Depending on where it happens, the result is different: a CSV import can merge separate products into one or overwrite an existing product, an app can fail with a “handle already taken” error, and products created in the admin can end up with handles like classic-tee-1.

All of these problems come from the same rule, so they’re fixed the same way. Each product needs its own unique handle, and you need to know which handle each product should keep before you import or rename anything.

What a Product Handle Does in Shopify

The handle is a product’s unique identifier in your store, and it forms the last part of the product’s web address. A product with the handle canvas-tote-navy appears at a URL ending in /products/canvas-tote-navy. Handles can contain letters, numbers and dashes, but no spaces, and Shopify creates one from the product title if you don’t set it yourself.

Handles also matter for imports. Shopify’s product CSV uses the URL handle column to decide which rows belong to the same product and which existing product a row should update. Titles and SKUs can repeat across products, but handles can’t, which is why a duplicate handle causes problems that a duplicate title never would.

Duplicate Handle Problems and How to Fix Them

Duplicate handles show up in four common ways. Find the situation that matches yours, then apply its fix.

Separate products merged into one after a CSV import

In a product CSV, every row with the same handle is treated as part of one product, usually as an extra variant or image. So if two different products in your file share a handle, Shopify combines their rows into a single product instead of creating two.

This often happens with supplier files where handles were generated from similar titles, or when products were copied and edited in a spreadsheet. For example, two products both titled “Classic Tee” might both get the handle classic-tee, even though one is cotton and one is linen.

To fix it, give each product its own handle in the file, such as classic-tee-cotton and classic-tee-linen. Keep the same handle on all rows that belong to one product, including its variant and image rows. If the merged product already exists in your store, delete or correct it before re-importing the fixed file.

An import skipped or overwrote an existing product

When a handle in your file matches a product already in your store, Shopify treats the row as that existing product. Without Overwrite products with matching handles selected, the row is skipped. With it selected, the row updates the existing product with your file’s values.

Both outcomes are correct when you’re updating products, but not when you meant to add something new. If a new product is missing after import, or an existing product suddenly has different details, check whether the new product’s handle was already in use.

The fix is to give the new product a different handle and import it again without the overwrite option. If an existing product was overwritten by mistake, restore its original values from a backup export before re-importing.

“Handle already taken” errors from apps

Apps that create products through Shopify’s API can fail with errors such as “Handle already in use. Please provide a new handle.” Since the Admin GraphQL API’s 2025-01 version, Shopify validates handles for uniqueness when apps create or update products. When an app supplies a handle that’s already taken, the request is rejected rather than adjusted.

There are two fixes. Change the app’s mapping so each product gets a unique handle, or stop sending a handle at all so Shopify generates one itself. Shopify only checks for duplicates when a handle is provided, so leaving the field unmapped avoids the conflict.

Some merchants have reported a stranger version of this error, where the message says the handle is already taken by a translation. In those cases, a translated version of another product used the same handle, and Shopify has acknowledged the behavior as a bug it’s investigating. If you see this message, check translated handles in your other languages for a match.

Handles ending in -1 or other added numbers

When you create or duplicate a product in the admin and its handle is already taken, Shopify typically adds a number to make it unique, such as classic-tee-1. The product works normally, but the URL doesn’t describe the product well and can be confusing to manage.

If the product is new and hasn’t been shared or indexed yet, simply change its handle to something descriptive. If it has been live for a while, rename it with a redirect, as described in the next section.

How to Change a Product Handle Safely

Change handles in the admin rather than through a CSV import. Open the product, go to the search engine listing section, edit the URL handle and keep the option to create a URL redirect selected. The redirect sends visitors and search engines from the old address to the new one, so existing links keep working.

Avoid renaming handles in a product CSV. Because the import matches rows to products by handle, a row with a new handle doesn’t match the old product. Instead of renaming it, the import creates a separate new product, leaving you with two copies.

Also check where the old handle is used before changing it. Links in navigation menus, blog posts, emails and ads may point to the old URL, and while the redirect covers visitors, updating important links directly keeps your store tidy.

How to Prevent Duplicate Handles

A consistent naming pattern prevents most duplicates. Build handles from the details that make each product distinct, such as brand-model-color, rather than from titles alone, which often repeat.

Check your file before importing, too. Each product’s first row is the one with a Title, so count only those rows. With handles in column A and titles in column B, =COUNTIFS(A:A,A2,B:B,"<>") returns more than 1 when two products share a handle.

Then compare new handles against an export of your existing products to catch ones already in use. Bulkflow supports bulk export of store data, which makes it easier to pull your current product list for that check.

Finally, use variants rather than separate products when items differ only by size, color or material. That removes the need for near-identical handles in the first place.

Conclusion

A duplicate handle in Shopify is a small detail with outsized effects, from merged products to failed app imports. Giving every product a unique, descriptive handle, checking files before import and renaming handles only in the admin with a redirect keeps your catalog and URLs clean. We hope this guide helps you resolve any duplicate handle issues in your Shopify store. If you manage product data in bulk, you can explore Bulkflow.