Skip to main content
All CollectionsTechnical help
How to create an import-ready CSV
How to create an import-ready CSV

Learn how to get started with importing redirects into your account.

Updated over a week ago

EasyRedir is pleased to provide a white-glove import service on applicable plans. A member of our team would be happy to help you with a CSV template for your import, just get in touch.

Prior to sending your import:

  • If you have current redirects in your account and would like to export them, you can do a current export yourself in your dashboard through the settings tab.

  • Choose and set your source hostname default settings. Once your redirect file has been imported, the default settings will automatically be applied to your new source hostnames.

Understanding how to fill out the import template:

  • The first column tells the importer the type of redirect that will take place. It can be either a "301" or "302", with most people using a 301 (permanent) redirect.

  • Enter your source URL(s) into the "sources" column. If you would like to redirect multiple source URLs to a single target URL, separate each source URL by 3 pipe characters (e.g. "|||") as shown in the second example row.

  • To support redirects on both www subdomain and the domain apex, add them both in the "sources" column (separated by 3 pipe characters - e.g. "|||").

  • We will automatically support both HTTP and HTTPS on your source URLs and provision SSL certificates for your domains once they have been modified to point to EasyRedir.

  • Apply partial path matching to the source URLs as needed.

  • The "target" column can be any single URL you wish to redirect to. The "sources" will be redirected to the "target".

  • Update the "forward_path" column to TRUE if you would like any path on the source URL to be forwarded to the target (e.g. if a visitor requests "source.com/example" and your target URL is set to "target.com", we will forward the visitor to "target.com/example". The default is FALSE. NOTE that URI (path) forwarding can only be enabled on the root of any given hostname.

  • Update "forward_params" to TRUE if you wish to forward any query parameters that come in with requests for your source URL. This allows for the use of UTM tags or other analytics tags. NOTE that query parameter forwarding can only be applied on source URLs that you define if they do not contain query parameters.

Items to pay special attention to:

  • Do not change the header titles in the CSV as they must exactly match to be imported.

  • Ensure there are no duplicate source URLs in the file as this can cause errors.

  • Ensure that the format of all URLs are valid. Examples of invalid URLs: spaces in the hostname, URLs that start with schemes/protocols other than "http://" or "https://".

  • Ensure there are no redirects whose source URL and target URL are on the same fully-qualified domain name (hostname).

When providing us with your CSV import filled out:

  1. Indicate whether we should replace the whole account or add to the account (if you already have redirects).

  2. Indicate whether duplicate redirects should be IGNORED or UPDATED, if there are duplicates being imported. Our default is to IGNORE duplicates.

  3. We will schedule the batch import with our technical team to upload into your account. As long as the CSV is without errors this process should happen in 1-2 business days. If we know the timing of these imports in advance, we can be quicker on the updates.

Steps to take after your import has been completed:

  1. Set any custom source hostname settings that require something different than your defaults.

  2. Configure your DNS through your DNS provider to our recommended values. If you have added both the domain apex and www subdomains to your account make sure to update both of the DNS records.

Did this answer your question?