Importing or Exporting URL Redirects with a CSV File

3 min read
A URL (301) redirect updates search engines with a working page URL if the page's URL has changed. Upload a CSV file to import up to 500 URL redirects at a time. You can upload your own CSV file or download the provided template to create a new CSV file for the import. 
A screenshot of the URL Redirect Manager with the Import Redirects option highlighted.

Before uploading your CSV file make sure that:
  • Each row in the file lists only one redirect.
  • The file only includes two columns. The first column should list the old URL and the second column should list the new URL to be redirected to.

Importing Your Redirects with a CSV File

Redirects can only be uploaded with a CSV file. The maximum number of redirects per file is 500. Any redirects listed after the first 500 will not be included in the import.

To import a file a redirects:

  1. Go to your SEO Dashboard.
  2. Select Go to URL Redirect Manager under Tools and settings.
  3. Click More Actions
  4. Click Import Redirects
  5. Click Upload CSV File.
    (Click Download Template if you need a template to create your file.) 
  6. Select your CSV file. 
  7. Click Open
  8. Select the type of redirect to import:
    • New: When the URL has no prior redirects.
    • Existing: When the URL already has a redirect setup. You can choose to override the existing redirect or not. By default, it will not be overridden. To override, switch the toggle on.
  9. Click Import Redirects
  10. Or click Replace File to upload a different CSV file. 
  11. Select the file and click Open
  • If you are uploading your own CSV file, make sure the first row of the table is the column headers.
  • To make changes to your existing redirects, export the redirects to a CSV file, make the changes, and then import the file to apply those changes. 

Fix CSV File Import Errors

If you get an error when importing your redirects, you can download the CSV report to see the status of each redirect. The report will look like your CSV file, but with additional columns listing the status of each redirect.

Download the report to make changes to your original CSV file by re-importing the file to overwrite the original file's content. This can be done to fix issues one-by-one or all at once. 

Common errors: the file is empty or in the wrong format, a redirect already exists for a URL, or the site is not connected to a domain.
A screenshot of an error message that can appear while importing redirects.

Exporting Redirects

You can export a CSV file of your entire list of redirects that have been uploaded to your site. If you need to make any changes to your redirects, you can edit this file, save, then re-upload. 

To export a list of redirects:

  1. Go to your SEO Dashboard.
  2. Select Go to URL Redirect Manager under Tools and settings.
  3. (When exporting specific redirects only) Select the redirects you want to export.
  4. Click More Actions.
  5. Click Export Redirects.
The file automatically starts downloading to your computer. 
A screenshot of the URL Redirect Manager with the Export Redirects option highlighted.

Did this help?