· DataEase · Tutorials  · 2 min read

Bulk Update Product URLs

Change many product URLs at once by updating product handles in a single CSV file. This guide shows how to prepare your file, run the import, and keep your SEO safe with redirects.

When to use

  • You renamed products and want clean, human-readable URLs.
  • You need to align handles with a new naming convention.
  • You are fixing messy, duplicate, or auto-generated handles.

How it works (in simple words)

  • A product’s URL is built from its handle. Example: /products/cotton-shirt
  • If you change the handle, the URL changes.
  • To keep your SEO, add a 301 redirect from the old URL to the new one.

Before you start

  1. Export a backup of your products (include at least: handle, title).
  2. Pick a safe time. Changing URLs can affect live traffic.
  3. Decide how you’ll handle redirects (recommended).

What you can update in one go

  • Product handle (this updates the URL).
  • Optional: Create 301 redirects from old to new.
  • Optional: Update SEO title and description together with the URL change.

Steps:

1. Export Products

In DataEase, create a New Export → Products. Include at minimum: id, handle (optionally title, seoTitle, seoDescription to review SEO).

2. Edit handles in your file

Set command = UPDATE and put the new value in handle. Use lowercase, hyphens (my-new-handle), avoid spaces/special characters. Each handle must be unique.

Changing handles breaks old URLs unless you create 301 redirects. Either enable automatic redirects in your store or prepare a separate redirects import/workflow.

4. Import & validate

In DataEase, create a New Import, upload the file, map columns, and run Validation. Open the validation file and fix any duplicate/invalid handles.

5. Run the import

Then spot-check a few products on the storefront to confirm the new URLs work (and that redirects resolve from old URLs, if configured).

Tips

  • Matching: prefer Product ID; use handle only if ID is missing.
  • SEO: changing the handle does not change seoTitle / seoDescription—edit them if needed.
  • If a handle already exists, validation will flag a conflict; pick a unique one.
  • Redirects are crucial to avoid 404s and preserve SEO.

Minimal CSV (example)

idcommandhandle
123UPDATEnew-handle

References