Start Free Trial
Start Free Trial

Redirects

Redirects (also known as 301 Redirects) are used to send site visitors from one URL to another – when migrating from your old e-Commerce platform, or when renaming Handles.

See what each field/column from our “Redirects” template means including possible allowed values and examples.

Excel Sheet Name

Redirects

To tell the app that you are importing Redirects you need:

  • If using CSV file then the file name needs to contain the word “redirect”, for example, “my-shopify-redirects.csv”
  • If using XLSX file then the sheet/tab name in the file needs to be “redirect”. The file name for the XLSX file does not matter.

Need a quick start?

Columns Available For Export And Import

Basic Columns

Column Description / Example Value
ID The ID is automatically generated number by Shopify to identify the item.
It is filled in by an Export.
Can be used for Import to identify and update existing Redirects.
When creating new Redirect, leave this value empty.

Allowed Values

Number

Example
44920047631
Path It is the “path” part of your old URL.
The path is used as a secondary key identifying the Redirect. If the ID is not found, then the app will look for the existing Redirect by the Path value.
The Path cannot be empty, and cannot be equal to Target.
Use it without the server name. For example, if your old URL is https://yourstore.com/your-old-path/to/somewhere, then your redirect Path should be:

Allowed Values

Any characters allowed in a URL

Example
/your-old-path/to/somewhere
Command When importing Redirect row – tell the app, what to do with it:

  • NEW: will try to create a new Redirect with the provided details. If such Redirect will already exist (with the same ID or same Path), then the result will be Failed.
  • MERGE: will try to find the existing Redirect, and update it with data from the row. If such a Redirect will not be found, then it will create new.
  • UPDATE: the app will search for an existing Redirect and update it. If an item cannot be found then that item will fail to import.
  • REPLACE: WARNING! Use this Command value to fully replace the whole redirect, not individual fields. Using this Command value, the app will delete the redirect from the store completely and create a new one only from data in the file, resulting in losing all data that is not included in the import file.
    If such Redirect with provided ID or Path exists, then the app will delete it. After that, it will create a new one. If an existing Redirect will not be found, then still the app will create a new one. The difference from UPDATE is that it will not keep any of columns, which were not included in the import file since the Redirect will be deleted and re-created.
  • DELETE: the app will delete the existing Redirect, which is found by ID or by Path. If such Redirect will not be found, then the result will be Failed. This DELETE command is very handy for deleting Redirects in bulk.
  • IGNORE: the app will ignore this Redirect and will skip it.

If no Command is specified, then the app will assume the UPDATE command.

Allowed Values
NEW
MERGE
UPDATE
REPLACE
DELETE
IGNORE
Example
MERGE
Target The target URL or target path of the new location.
it can be the full URL like “https://anotherstore.com/products/your-new-product-handle“, or if the redirect should send visitors to the current store, then you can put just the new path part, like “/products/your-new-product-handle“.The Target cannot be empty, and cannot be equal to Path.

Allowed Values

Any characters allowed in a URL

Example
/products/your-new-product-handle