> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scayla.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Import 301 redirects in bulk

> If you're migrating to Shopify or need to create several 301 redirects, save time by importing your URL redirects in bulk using a CSV spreadsheet.

## 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

<Info>
  All plans include unlimited 301 redirect visits and bulk import functionality.
</Info>

## Prepare your CSV file

<Check>
  Download a copy of our [spreadsheet template](https://docs.google.com/spreadsheets/d/1WjPgXRC3c1XXkzrksNq5DXDbSRtxzPjPqWLtjhALTXo/edit?usp=sharing) to make sure you have the right column headers.
</Check>

### 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)

<Note>
  **Remember to include column headers** - the CSV should have "Redirect from" and "Redirect to" in the first row.
</Note>

### CSV import file example

| Redirect from       | Redirect 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: `/` ✓

<Tip>
  Use lowercase letters and hyphens in URL paths. Avoid spaces, uppercase letters, or special characters.
</Tip>

## Import your redirects

<Steps>
  <Step title="Open Redirect Pro">
    From your Shopify admin, open the **Redirect Pro** app.
  </Step>

  <Step title="Go to Import redirects">
    Click **Import redirects** in the app navigation menu.
  </Step>

  <Step title="Click the Import redirects button">
    Click the **Import redirects** button.
  </Step>

  <Step title="Name your import">
    Enter a **name** for your import file so you can find it later.
  </Step>

  <Step title="Upload your CSV file">
    Click **Add file** and select your prepared .csv file from your computer.

    <Check>
      Download a copy of our [spreadsheet template](https://docs.google.com/spreadsheets/d/1WjPgXRC3c1XXkzrksNq5DXDbSRtxzPjPqWLtjhALTXo/edit?usp=sharing) to make sure you have the right column headers.
    </Check>
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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.

<Warning>
  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.
</Warning>

## Common reasons files are rejected

If your file won't upload, check for these issues:

<AccordionGroup>
  <Accordion title="Wrong file format">
    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.
  </Accordion>

  <Accordion title="Missing or incorrect column headers">
    The first row must contain exactly these headers in these cells:

    * Cell A1: `Redirect from`
    * Cell B1: `Redirect to`

    **Incorrect**:

    ```csv theme={null}
        Old URL,New URL
        /old-page,/new-page
    ```

    **Correct**:

    ```csv theme={null}
        Redirect from,Redirect to
        /old-page,/new-page
    ```

    Headers are **case-sensitive** and must match exactly.
  </Accordion>

  <Accordion title="Missing or extra columns">
    Each row must have exactly two columns separated by one comma.

    **Incorrect**: `/old-page,/new-page,extra-column` ✗

    **Correct**: `/old-page,/new-page` ✓
  </Accordion>

  <Accordion title="Empty rows or extra spaces">
    Remove any blank rows and trim extra spaces around URLs.

    **Incorrect**: `/old-page ,  /new-page` ✗

    **Correct**: `/old-page,/new-page` ✓
  </Accordion>
</AccordionGroup>

<Note>
  If your file is rejected, the error message will tell you which specific issue was found. Fix the issue and try uploading again.
</Note>

## 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](/redirect-pro/help/redirect-issues/redirects-failed-to-import) for troubleshooting.

## Tips for successful imports

<Accordion title="Test with a small file first">
  Before importing thousands of redirects, test with a small CSV file (10-20 redirects) to verify your formatting is correct.
</Accordion>

<Accordion title="Keep a backup copy">
  Save a copy of your original CSV file before importing. This helps if you need to troubleshoot or re-import later.
</Accordion>

<Accordion title="Split very large imports">
  For imports over 10,000 redirects, split your CSV into multiple files and import them separately.
</Accordion>

<Accordion title="Validate URLs beforehand">
  Check that all URLs in your file are formatted correctly before importing to minimize errors.
</Accordion>

## 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

## Related guides

* [Create a redirect](/redirect-pro/guides/managing-301-redirects/create-301-redirect) - Add individual redirects manually
* [Edit or delete redirects](/redirect-pro/guides/managing-301-redirects/edit-delete-301-redirects) - Manage imported redirects
* [Search and filter redirects](/redirect-pro/guides/managing-301-redirects/search-filter-301-redirects) - Find imported redirects

## Need help?

Having trouble with your import? Check these troubleshooting guides:

* [Import file rejected](/redirect-pro/help/redirect-issues/import-file-rejected) - File format issues
* [Redirects failed to import](/redirect-pro/help/redirect-issues/redirects-failed-to-import) - Fix validation errors