GuidesAPI DocsLatest NewsStatusCreate Support RequestReturn to zoey.com
Guides

URL Redirects

Suggest Edits

👍

Zoey also has 301 Redirects for SEO

Learn how to set up and import 301 Redirects here.

📘

Category URLs can be redirected in the Category Settings as well.

Click here to learn how to redirect Category URLs with ease.

The terms rewrite, and redirect are used interchangeably.

What is a URL Redirect

URL Redirects are used to keep your store's navigation seamless. They are automatically created when categories are moved or URL keys are changed. This negates the need to update all the links on your store when pages are moved.

🚧

URL Redirects only need manual adjustment if there is a navigation issue on your store.

If you are being brought to the wrong URL when clicking a link in your store, you can search for that URL Redirect and delete it. Learn how to delete redirects here.


Searching for URL Redirects

Start by going to Products > Categories and grab the "ID" - this will be a 3 or 4 digit number.

In the URL redirects, you can search the Request Paths with the category's URL to return all redirects affecting that category.

  • For example, searching smoothies/super-detox-smoothies/test-category in the Request Path will return the redirects affecting that category.

You can also search the Target Path to find all redirects which bring customers to specific URLs.

  • For example, you can search catalog/category/view/id/9999 (replace the "9999" with the ID you're looking for) in the Target Path to return all redirects pointing to that category.

You can then make adjustments/delete the redirects you do not want. Learn more here.

Finally, process a re-index to fully update your store.

Field Descriptions

OptionsDescriptions
TypeIndicates the type of rewrite. The type cannot be changed after the rewrite is created. Options include:
For category
For product
Custom
ID PathThe unique identifier for the rewrite rule.
For products and categories, the ID Path is automatically generated and includes the type and ID#. For example:
product/164

For a custom rewrite, enter the relative path of the page to be redirected. For example:
brandname
brand/brandnamebrand/search/result/brandname
Request PathThe URL key of the page that is to be redirected. For a custom redirect, the ID Path and Request Path might be the same. Depending on your configuration, it might include the .html suffix and category. For example:
brandname
brand/brandname
brand/brandname.html

The Request Path is unique, and must not have been used previously. If you have made several attempts to redirect the same page, you should delete any unsuccessful redirects and refresh your cache.
Target PathThe URL that points to the destination page. The Target Path can be a different CMS page, or the result of a search.

For a product or category, the Target Path is automatically generated and cannot be edited. For example:
catalog/product/view/id/164

For a custom rewrite, the Target Path is entered manually. To avoid getting a 404 "Page Not Found" error, it must exactly match what the system expects to find. The following examples are valid target paths:
brandname
brand/brandname
catalogsearch/advanced/result/?brand=brandname
RedirectIndicates the type of redirect. Options include:
No
Temporary (302)
Permanent (301)
DescriptionDescribes the purpose of the redirect. This field is for reference and is not visible to customers

How to add URL Redirects

  1. Navigate to Advanced > URL Rewrite
  2. In the upper-right corner, click the Add URL Rewrite button.
  3. In the Add New URL Rewrite section, set Create URL Rewrite to "for Catalog."
  4. In the category tree, click to select the category that needs the rewrite. You can only work on one category at a time.
  5. In the URL Rewrite section, do the following:
  • In the Request Path field, enter the new value for the updated URL. The Request Path must be unique for each rewrite.
  • Set Redirect to one of the following:
    Permanent (301) - best option for SEO
    Temporary (302)
  • For your own reference, enter a brief description of the rewrite.
  1. When complete, click the Save button.

To Add a Custom Rewrite

  1. Navigate to Advanced > URL Rewrite
  2. In the upper-right corner, click the Add URL Rewrite button.
  3. In the Add New URL Rewrite Information section, set Create URL Rewrite to "Custom."
  4. In the URL Rewrite Information section, do the following:
  • In the ID Path field, enter the unique identifier of the original URL. To redirect any page in your store, enter the relative path to the page. For example: brand/search/result/brandname
  • In the Request Path field, enter the same original URL. The Request Path must be unique for each rewrite.
  • In the Target Path field, enter a valid URL for the new destination. To redirect to another CMS page in your store, enter the relative path to the new page, without a leading forward slash. To redirect to a page on different site, enter the fully qualified URL of the new destination. For example:
    new-page (URL Key of target page)
    somewhere/new-page (Relative path to target page, without a leading forward slash)
    http://www.zoeycommerce.com/ (Fully qualified URL of target page on external website)
  • Set Redirect to one of the following:
    Temporary (302)
    Permanent (301) - best option for SEO
  • For your own reference, enter a brief description of the rewrite.
  1. When complete, click the Save button.

Updated 7 months ago