Shopify Store Migration Redirects

Last updated August 2026

URL redirects are the most important post-migration task for preserving SEO value. Shopify's Store Migration app does not create them automatically.

Shopify redirect format

Redirects are created with a **path** (the old URL) and a **target** (the new URL):

{

"redirect": {

"path": "/old-product-page/",

"target": "/products/new-product-slug"

}

}

Creating redirects

Via Shopify admin

Go to **Settings → Navigation → URL Redirects** and add redirects manually or via CSV import.

Via Shopify API

URL redirects can be created via the Shopify admin (bulk import) or the GraphQL Admin API at /admin/api/2026-07/graphql.json.

Via CSV import

Prepare a CSV with two columns: `path` and `target`. Import in Shopify admin.

Redirect best practices

1. **One-to-one mapping** — Each old URL should redirect to exactly one new URL

2. **301 (permanent)** — Use 301 redirects for SEO value transfer

3. **Avoid chains** — Don't redirect to a redirect (A → B → C). Point directly to the final URL.

4. **Test after import** — Spot-check a random sample of redirects

5. **Prioritize by traffic** — Import high-traffic URLs first

6. **Handle query parameters** — Shopify ignores query strings in redirect matching

Limits and constraints

Platform-specific redirect patterns

WooCommerce

Old: `/product/product-name/` → New: `/products/product-name`

Old: `/product-category/category-name/` → New: `/collections/category-name`

Magento

Old: `/catalog/product/view/id/123` → New: `/products/product-name`

Check `url_rewrite` table for custom paths.

PrestaShop

Old: `/category/id-product-name.html` → New: `/products/product-name`

VTEX

Old: `/department/category/product-name/p` → New: `/products/product-name`

For complex redirect requirements

If you need pattern-based redirects, header manipulation, or more than 100,000 redirects: