Skip to main content

​
When to use bulk import

Import redirects when you:
  • Migrate from another platform - preserve SEO from your old site
  • Restructure your site - change multiple URLs at once
  • Fix multiple broken links - create many redirects quickly
All plans include unlimited 301 redirect visits and bulk import functionality.

​
Prepare your CSV file

Download a copy of our spreadsheet template to make sure you have the right column headers.

​
Required file format

Your import file must be a CSV (Comma-Separated Values) file with exactly two columns:
  1. Column 1: Redirect from (old URL)
  2. Column 2: Redirect to (new URL)
Remember to include column headers - the CSV should have “Redirect from” and “Redirect to” in the first row.

​
CSV import file example

Redirect fromRedirect to
/old-product/products/new-product
/blog/old-post/blogs/news/new-post
/pages/about-us-old/pages/about

​
URL format guidelines

Redirect from (Column A):
  • Use URL paths only: /old-page ✓
  • Can include query parameters: /old-page?id=123 ✓
  • Don’t include domain: https://yourstore.com/old-page ✗
Redirect to (Column B):
  • Internal pages: /products/shirt ✓
  • External URLs: https://example.com ✓ (must include full URL with https://)
  • Homepage: / ✓
Use lowercase letters and hyphens in URL paths. Avoid spaces, uppercase letters, or special characters.

​
Import your redirects

1

Open Redirect Pro

From your Shopify admin, open the Redirect Pro app.
2

Go to Import redirects

Click Import redirects in the app navigation menu.
3

Click the Import redirects button

Click the Import redirects button.
4

Name your import

Enter a name for your import file so you can find it later.
5

Upload your CSV file

Click Add file and select your prepared .csv file from your computer.
Download a copy of our spreadsheet template to make sure you have the right column headers.
6

Start the import

Click Save in the Shopify search bar at the top of the page to begin the import. Large imports may take a few minutes to process and will appear on the Import redirects page when complete.

​
What happens after import

When processing completes, Shopify sends an Import URL Redirect Summary email to your store’s admin email address showing:
  • Created - New redirects successfully added
  • Updated - Existing redirects that were modified (when a “Redirect from” URL already existed)
  • Errors - Failed redirects with the error message and CSV row number
Successful redirects are active immediately. Failed redirects must be corrected in your CSV and re-imported - the email tells you exactly what went wrong and on which line.
If importing a large number of redirects (1,000+), the process may take several minutes. You can continue working and you’ll receive an email when it’s complete.

​
Common reasons files are rejected

If your file won’t upload, check for these issues:
Your file must be saved as .csv (Comma-Separated Values).Not accepted:
  • Excel files (.xls, .xlsx)
  • Tab-separated values (.tsv)
  • CSV files using semicolons, tabs, or pipes as delimiters
How to fix: In Excel or Google Sheets, use File > Save As and choose CSV (Comma delimited) as the file type.
The first row must contain exactly these headers in these cells:
  • Cell A1: Redirect from
  • Cell B1: Redirect to
Incorrect:
    Old URL,New URL
    /old-page,/new-page
Correct:
    Redirect from,Redirect to
    /old-page,/new-page
Headers are case-sensitive and must match exactly.
Each row must have exactly two columns separated by one comma.Incorrect: /old-page,/new-page,extra-column ✗Correct: /old-page,/new-page ✓
Remove any blank rows and trim extra spaces around URLs.Incorrect: /old-page , /new-page ✗Correct: /old-page,/new-page ✓
If your file is rejected, the error message will tell you which specific issue was found. Fix the issue and try uploading again.

​
Handling import errors

If some redirects fail to import, the Import URL Redirect Summary email you receive from Shopify will contain:
  • The line number where the error occurred
  • The specific error
  • The redirect that failed
See Redirects failed to import for troubleshooting.

​
Tips for successful imports

Before importing thousands of redirects, test with a small CSV file (10-20 redirects) to verify your formatting is correct.
Save a copy of your original CSV file before importing. This helps if you need to troubleshoot or re-import later.
For imports over 10,000 redirects, split your CSV into multiple files and import them separately.
Check that all URLs in your file are formatted correctly before importing to minimize errors.

​
After importing

Once your redirects are imported:
  • Test a few sample redirects to ensure they work correctly
  • Review your redirect list to verify all expected redirects were created

​
Need help?

Having trouble with your import? Check these troubleshooting guides: