Import redirects from a CSV file

Import a whole list of redirects at once from a CSV file in Site settings > Redirects. Each row of the file sends an old path to its new destination, a preview shows you exactly what will be added before anything is saved, and saved redirects take effect immediately.

Prepare the CSV file

The file must be a UTF-8 CSV with two columns: From holds the old path visitors used, and To holds the destination they should land on now. A CSV template with these columns is available in Site settings > Redirects, so you can fill it in instead of building the file from scratch.

In To, enter either a path on your site, such as /blog, or a full address that starts with http or https.

Keep the file within two limits: it can be up to 10 MB and contain up to 10,000 redirects per import.

Import and preview the file

1. Open the site's Settings.

2. Click Redirects in the sidebar.

3. Choose the option to import from a file and select your CSV file.

4. Review the preview, which shows the new redirects the file contains before anything is saved.

Entries identical to redirects you already have are skipped, so they are not added again.

Fix reported issues

Before the import saves, the results report two kinds of problems, each with its row number: normalization issues in the paths, and conflicts with redirects you already have. The row number tells you which line of the file to fix.

1. Note the row numbers listed in the results.

2. Correct those rows in your CSV file.

3. Import the corrected file again.

Save the import

Saving adds the file's redirects to your list. The file is checked again at save time, so what gets saved matches the preview you reviewed.

Importing only adds entries. Redirects you already have are never replaced or removed.

After the import, a destination that matches a path inside your site is linked to its Page or CMS target. Destinations that do not match stay as the literal path or URL from the file.

To add redirect rules one by one instead, see Add, edit, and delete site redirects, and read How site redirects work for how matching, wildcards, and query parameters behave. If you also want search engines to show a preferred address for your pages in their metadata, see Set canonical URLs for a site.