301 Redirects

Not only does Zoey have a built-in URL Rewrite option, we also allow merchants to import URL redirects.
This allows you to efficiently preserve your URLs from an older website, which is helpful for maintaining SEO.

Before You Begin

  • 301 Redirects indicate a permanent change in your URL to search engines. 302 redirects indicate a temporary change. We recommend 301 redirects for SEO.
  • If Zoey cannot find a valid redirect, your store will present visitors that access the URL with a 404 error page.
  • Our redirect import tool implements a best match approach. This means that once a matching redirect path is validated, Zoey will utilize it and ignore the rest of the the uploaded CSV.

Visit Import Redirect Settings

In your Control Panel, select the Import/Export > 301 Redirects.

Select a Redirect Import Method

On the Mass Redirects page, you can choose between two methods of importing your redirect. The first you will see is Redirects System v1.0.

The CSV file you upload will need to have three columns containing the following values:

  • Old URL
  • New URL
  • Status Code (either "301" or "302")

Our second option, Query String, can be utilized by scrolling down and expanding the Query String Based Redirects settings.

Your CSV will have five columns containing the following values:

  • Old URL
  • Query String Name
  • Query String Value
  • New URL
  • Status Code (either "301" or "302")


Query String Redirect

Query string redirect imports were developed for retailers migrating from older ecommerce platforms. If you do not have a query string in your redirects, we generally recommend using Redirects System v1.0. If you need further clarification, please contact Zoey Support.


Match Basis

This module works on a best match basis. For example, if you have a redirect for the cat_id query before the prod_id query, both the above URLs will redirect to the category page. This is because cat_id is the best match. If you setup prod_id before cat_id, then the product page would take priority. Rarely, an older ecommerce system may call both the category id and product id in the same URL.

Upload File

Go to Import & Export > 301 Redirectsand from either the Redirects v.1.0 or Query String option, click Choose File.

Configure File Download Options (Optional)

After uploading your file, you can download the file from Zoey.

Download Redirects Filedownload the redirect file from Zoey to your computer
DelimiterEnter a character to separate your values in the downloaded .CSV file. The default delimiter is a comma (",").
Wildcard CharacterWildcard characters are characters used to filter results in a .CSV. enter a character for your downloaded .CSV file. Zoey defaults to asterisk "*".


When you finish uploading your redirect imports, click Save Config

Additional Information


How do I export my active url data from Zoey so I can create a 301 Redirects CSV file?

You can get all URLs for your products by performing a basic product export. Navigate to Import & Export>Export Products


301 CSV import not working, still going to old page

The 301 CSV import tool will only create 301 redirects for pages that will result in a 404. If your old URL still renders a page, you should use the Advanced>URL Rewrite tool and not the CSV import tool.


URL Redirects for Disabled Products

  • Go to Web Settings > URL Redirects for URL Path (in the 'Request Path" column)
  • If it's there, look for the "Product ID" in the ID Path, it will be a number like "203"
  • Go to Products > Products List, click on any product, then replace the end of the URL in the browser bar with the ID from step 2. URL should end like this: /#/zoeyproduct/edit/203
  • Change the URL Key for product ID 203 to something like "...-disabled"
  • Go back to Web Settings > URL Redirects, click Edit on the URL rewrite with that product ID, then click the "Delete" button
  • Re-Index and Flush Cache.


Sitewide HTTPS

If you have enabled Sitewide HTTPS meaning that every page including the homepage, info pages, category pages and product pages load in https://, you must ensure your import file has https:// in both columns in order for 301 redirects to work. It will not work with http, or www.

When sitewide HTTPS is enabled, any URLs that are http will be automatically 302-ed to https. It is at this point that the check for the 301 happens. If your import file has http in the first column, the 301 will never work.