For the complete documentation index, see llms.txt. This page is also available as Markdown.

URL Mapping

Redirect users from Old Destination URL to a specific New Destination.

The URL Mapping feature is designed to redirect visitors from a 404 page in the destination store to an available page in the destination store. This will ensure a smooth transition from an unavailable page to an available page.

With URL Mapping, you can redirect users from an Old Destination URL to a New Destination URL.

Example Scenario:

You have two Shopify stores:

  • USA Store → geoip-country-redirect-demo.myshopify.com

  • Canada Store → sg-local-app.myshopify.com

A Shirt product exists in both stores. However, the shirt in the Canadian store became unavailable. Instead of users landing on a broken or unavailable page, you want to redirect them to an alternative product page.

How URL Mapping Works:

If a user tries to visit: Product URL in the USA store: https://geoip-country-redirect-demo.myshopify.com/products/shirt-1

Instead of being redirected to the same product URL in the Canadian store (sg-local-app.myshopify.com/products/shirt-1), they will be redirected to (sg-local-app.myshopify.com/products/shirt-2) (a new mapped URL in the app).

This ensures a smooth user experience by redirecting visitors to an active and relevant product page instead of a discontinued or unavailable one.

Step 1: Click on Edit Redirection Rule

Step 2: Navigate to “Advance Setting”

Step 3: Activate the URL Mapping option

Click on Checkbox to activate the URL Mapping functionality

Note: The Relative redirect setting must be enabled for the URL Mapping functionality to work.

Step 4: Add “URL Mapping”

Click on the "Add Mapping" to add the URLs for the mapping

Step 5: Add path/URL in "Redirect From" and Select the Type

  • Redirect From – Enter the path/URL from which you want to redirect the visitors to the new destination URL.

  • Type: Exact –Redirect users when the exact path is matched in the “Redirect from” field. It requires a complete URL to be added in the Redirect From field. Contains – Redirect users when the contents added in the Redirect from field is detected. The /path is required to be added if the Contains type is selected.

Examples of Exact and Contains:

For Exact - add the URL [sg-local-app.myshopify.com/products/shirts-1] For Contains - add the path [/products/shirts-1]

Step 6: Select the type in the "Redirect To" field and add the destination URL in the "New Destination URL" field.

New Destination URL – Add the New Destination URL on which you want to redirect visitors.

  • Origin: Add the required /path of the new page. This will redirect visitors to the new Destination URL.

  • Origin + Locale: Add the /path and it will add locale to the path (if available)

  • Full URL: Add the complete URL of the New destination page.

Examples of the above options:

With Origin: Add the path /products/shirt-2 With Origin + Locale: Add the path /products/shirt-2. This will add the language locale to the URL en/products/shirt-2 With Full URL: Add the complete URL - https://sg-local-app.myshopify.com/products/shirt-2

Step 7: Click on Save to apply the changes

In case of any queries, please feel free to reach us at help@spicegems.com

Last updated