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 redirects | URL Redirects | |
|---|---|---|
| Location | Import & Export > 301 Redirects | Advanced > URL Rewrite |
| Use when | The old URL would otherwise show a 404 "Page Not Found" page | The old URL still loads a page |
| How redirects are added | Uploaded in bulk with a CSV file | Created automatically when URL keys change, or added one at a time |
| Listed in Web Settings > URL Redirects | No. 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 enabledIf 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 withhttps://.When sitewide HTTPS is enabled, Zoey sends any
http://URL to itshttps://version with a 302 redirect before it checks for a 301 redirect. If the first column of your file useshttp://, 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.
| Method | When to use it | CSV columns |
|---|---|---|
| Redirects System v1.0 | Most redirects. Use this method unless your old URLs rely on query strings. | 3 |
| Query String Based Redirects | Old 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:
- Go to Web Settings > URL Redirects and search for the product's URL in the Request Path column.
- If you find it, note the product ID in the ID Path column. It's a number such as
203. - 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. - Change the product's URL Key to something like
...-disabled, then save. - Go back to Web Settings > URL Redirects, click Edit on the URL rewrite with that product ID, then click Delete.
- Reindex and flush cache. See Re-Indexing Your Store.
Related Articles
Updated 20 days ago
