301 Redirects

How imported 301 and 302 redirects work in Zoey, which import method to use, and how to fix redirects that don't work.

Zoey can send visitors and search engines from old URLs to new ones using redirects you import from a CSV file. Imported redirects help you keep your search rankings when you move from an older website or change URLs.

This article explains how imported redirects work, which import method to use, and how to fix common problems. For step-by-step upload instructions, see URL Rewrite - 301 Redirect Import.

Imported Redirects vs. URL Redirects

Zoey has two ways to redirect URLs. Use the one that matches how the old URL behaves today.

Imported redirectsURL Redirects
LocationImport & Export > 301 RedirectsAdvanced > URL Rewrite
Use whenThe old URL would otherwise show a 404 "Page Not Found" pageThe old URL still loads a page
How redirects are addedUploaded in bulk with a CSV fileCreated automatically when URL keys change, or added one at a time
Listed in Web Settings > URL RedirectsNo. This is expected behavior.Yes

How Imported Redirects Work

  • 301 vs. 302: A 301 redirect tells search engines the URL has changed permanently. A 302 redirect tells them the change is temporary. Use 301 for SEO.
  • 404 pages only: Imported redirects only apply to URLs that would otherwise show a 404 page. If Zoey can't find a valid redirect for a URL, visitors see the 404 page.
  • Best match: Once Zoey validates a matching redirect path, it uses that redirect and ignores the rest of the uploaded CSV, so the order of your rows matters.
🚧

Use https:// in both columns if sitewide HTTPS is enabled

If sitewide HTTPS is enabled, so every page on your store loads with https://, both the Old URL and New URL in your CSV must start with https://.

When sitewide HTTPS is enabled, Zoey sends any http:// URL to its https:// version with a 302 redirect before it checks for a 301 redirect. If the first column of your file uses http://, the 301 redirect never triggers.

  • Doesn't work: http://mysite.com/aaaaa,http://mysite.com/bbbbb
  • Doesn't work: http://mysite.com/aaaaa,https://mysite.com/bbbbb
  • Works: https://mysite.com/aaaaa,https://mysite.com/bbbbb

Choose an Import Method

The 301 Redirects page offers two import methods.

MethodWhen to use itCSV columns
Redirects System v1.0Most redirects. Use this method unless your old URLs rely on query strings.3
Query String Based RedirectsOld URLs that use query strings, typically from older ecommerce platforms.5

If you aren't sure which method fits your URLs, contact Zoey Support. For the column formats of each method, see URL Rewrite - 301 Redirect Import.

How best match affects query string redirects

Row order matters when a URL contains more than one query string. For example, if your CSV has a redirect for the cat_id query string before one for prod_id, a URL containing both redirects to the category page, because cat_id matches first. Put the prod_id row first if you want the product page to take priority. Some older ecommerce platforms include both the category ID and product ID in the same URL.

Optional: Export Your Current Product URLs

To build a redirect file for your products, start with a list of their current URLs. Go to Import & Export > Export Products and run a basic product export, which includes the URL for every product.

Troubleshooting

The old URL still loads the old page

Imported redirects only apply to URLs that would otherwise show a 404 page. If the old URL still loads a page, Zoey shows that page and ignores your imported redirect. Use URL Redirects instead.

If the old URL is a blog post, unpublish the post first. For the full steps, see Redirect a Blog Post to Another Website.

The old URL shows a 404 page instead of redirecting

  • Check that the Old URL in your CSV matches the address exactly, including https:// and any trailing slash. If the page can be reached at more than one address, add a row for each version.
  • If sitewide HTTPS is enabled, check that both columns start with https://.
  • Confirm you clicked Save Config and refreshed your store, then test again in a private browser window.

A disabled product's URL doesn't redirect

A disabled product's URL can still have an entry in URL Redirects. To clear it:

  1. Go to Web Settings > URL Redirects and search for the product's URL in the Request Path column.
  2. If you find it, note the product ID in the ID Path column. It's a number such as 203.
  3. Go to Products > Products List and open any product. In your browser's address bar, replace the ID at the end of the URL with the ID from step 2. The URL should end like this: /#/zoeyproduct/edit/203.
  4. Change the product's URL Key to something like ...-disabled, then save.
  5. Go back to Web Settings > URL Redirects, click Edit on the URL rewrite with that product ID, then click Delete.
  6. Reindex and flush cache. See Re-Indexing Your Store.

Related Articles


Did this page help you?