Custom Rewrites

A custom rewrite can be used to manage miscellaneous redirects, such as redirecting a page from your store to an external website. For example, you might have two Magento websites, each with their own domain. You can use a custom redirect to reroute requests for a product, category, or page to the other website. Unlike other redirect types, the target of a custom redirect is not chosen from a list of existing pages in your store.

Before you begin, make sure that you understand exactly what the redirect is to accomplish. Think in terms of “target” and “original request”, or “redirect to” and “redirect from”. Although people might still navigate to the former page from search engines or outdated links, the redirect causes your store to switch to the new target.

Add URL Rewrite

Step 1. Plan the Rewrite

To avoid mistakes, write down the URL of the “redirect to” page, and the URL key of the “redirect from” page.

If you are not sure, open each page, and copy the URL from the address bar of your browser.

Custom Path

Redirect to:

Redirect from:


Step 2. Create the Rewrite

  1. On the Admin sidebar, tap Marketing. Then under SEO & Search, choose URL Rewrites.

  2. Before you proceed, do the following to verify that the “request path” is available:

    • In the search filter at the top of the Request Path column, enter the URL key of the page that is to be redirected. Then, tap Search.

    • If there are multiple redirect records for the page, find the one that matches the applicable store view. Then, open the redirect record in edit mode.

    • In the upper-right corner, tap Delete. When prompted, tap OK to confirm.

  3. When you return to the URL Rewrites page, tap Add URL Rewrite.

  4. Set Create URL Rewrite to “Custom”.

  5. Under URL Rewrite Information, do the following:

    • If you have multiple store views, select the Store where the rewrite applies.

    • In the Request Path field, enter the URL key and path—if applicable—of the product, category, or CMS page that is to be redirected.

      The Request Path must be unique for the specified store. If there is already a redirect that uses the same Request Path, you will receive an error when you try to save the redirect. The previous redirect must be deleted before you can create a new one.

    • In the Target Path field, enter the URL of the destination. If the target is located on another website, enter the fully qualified URL.

    • Set Redirect to one of the following:

      • Temporary (302)
      • Permanent (301)
    • For your reference, enter a brief description of the rewrite.

    Custom URL Rewrite

  6. Before saving the redirect, review the following:

    • The Request Path contains the URL key or path of the original “redirect from” page.
    • The Target Path contains the URL of the “redirect to” page.
  7. When complete, tap Save.

    The new rewrite appears in the grid at the top of the list.

    Saved URL Rewrite

Step 3. Test the Result

  1. Go to the home page of your store.

  2. Do one of the following:

    • Navigate to the original “redirect from” page.
    • In the address bar of the browser, enter the name of the original “redirect from” page immediately after the store URL. Then, press Enter.

    The new target page appears instead of the original page request.

Field Descriptions

Create URL Rewrite
Indicates the type of rewrite. The type cannot be changed after the rewrite is created. Options:CustomFor categoryFor productFor CMS page
Request Path
The path to the product, category, or CMS page that is to be redirected. Depending on your configuration, the Request Path might include the .html or .htm suffix. The Request Path must be unique, and cannot be in use by another redirect. If you receive an error that the Request Path already exists, delete the existing redirect, and try again.
Target Path
The path or URL that is the destination of the redirect.
Determines the type of redirect. Options:
  • No - No redirect is specified.Many operations create redirect requests of this type. For example, every time you add products to a category, a redirect of the “No” type is created each store view.
  • Temporary (302) - Indicates to search engines that the rewrite is for a limited time. Search engines generally do not retain page rank information for temporary rewrites.
  • Permanent (301) - Indicates to search engines that the rewrite is permanent. Search engines generally retain page rank information for permanent rewrites.
Describes the purpose of the rewrite for internal reference.