Shopify redirect CSV:
check your map before import.
Spot conflicting destinations, self-redirects and chains in your planned redirect map. Check up to 1,000 rows free, without an account or sending your CSV to our servers.
The checker reviews exact URL pairs. It cannot approve a Shopify import, install redirects or prove that they work on your store. Its exported findings report is not a Shopify import file.
1. Find the problems in this map
These are fictional learning files. Replace the paths with your own before any store use. To reproduce the example, paste the CSV into the audit with https://example.com as the source website. No example URL is visited.
Scroll sideways in the CSV to read long lines.
Redirect from,Redirect to
/products/old-mug,/collections/ceramics
/collections/ceramics,/collections/homeware
/products/blue-mug,/products/cobalt-mug
/products/blue-mug,/products/navy-mug
/pages/delivery,/pages/delivery
/blog/old-guide,/blogs/journal/mug-care6 rows: 3 errors · 1 needs review · 2 clear
The audit numbers include the header as row 1. Here is what needs attention:
- Row 2 · a chain
- The old mug points to the ceramics collection, which points onward to homeware in row 3. If homeware is the intended final destination, point the old mug there directly.
- Rows 4 and 5 · conflicting destinations
- The blue mug has two different destinations. Decide which product should replace it and keep one rule. The checker cannot make that content decision for you.
- Row 6 · a self-redirect
- The delivery page points to itself. Remove that row if no URL change is intended.
Rows 3 and 7 are structurally clear. That does not mean their source pages are eligible for Shopify redirects or their destinations exist.
2. Correct the original map and recheck
For this example, we chose cobalt as the correct replacement for the blue mug, sent the old mug directly to homeware and removed the self-redirect. Your map needs your own destination choices.
Scroll sideways in the CSV to read long lines.
Redirect from,Redirect to
/products/old-mug,/collections/homeware
/collections/ceramics,/collections/homeware
/products/blue-mug,/products/cobalt-mug
/blog/old-guide,/blogs/journal/mug-care4 rows: 0 errors · 0 needs review · 4 clear
“Clear” describes the map structure only. These redirects have not been installed or tested on a store.
3. Take your own file through the same check
- Enter your actual source website. This lets the audit resolve your relative paths correctly.
- Upload or paste your CSV. Use
Redirect from,Redirect toheaders. The browser audit handles up to 1,000 rows and files up to 4 MB. - Review the findings. Download the report if useful, then correct your original two-column map. Do not import the findings report into Shopify.
- Run the corrected map again. Resolve errors and review warnings in context before importing.
More than 1,000 rows? The free local CLI and GitHub Action check up to 10,000 rows on your computer or runner. They do not visit the URLs either.
4. Review the Shopify import, then test live
In Shopify, go to Content → Menus → URL redirects to import your corrected CSV. Review the import before applying it. Use relative destinations within your primary domain and full URLs for another domain.
Shopify needs an eligible broken source URL: an active page or reserved path can prevent a redirect even when the map is structurally clear. Check Shopify’s current redirect restrictions and import instructions. Our CSV check does not test those conditions.
After installation, check actual HTTP responses and the destination content. Test any query handling and other store-specific behavior you rely on. A clear CSV does not establish indexing or search rankings.
For a separate check of HTTP redirects, our free live-check preview supports five URL pairs for seven days on hostnames you authorize through DNS. It does not verify page content, canonical tags or rankings.