· 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
- Export a backup of your products (include at least: handle, title).
- Pick a safe time. Changing URLs can affect live traffic.
- 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.
3. (Optional but recommended) Plan redirects
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)
| id | command | handle |
|---|---|---|
| 123 | UPDATE | new-handle |