> For the complete documentation index, see [llms.txt](https://help.spicegems.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.spicegems.com/geoip-country-redirect/country-redirect/url-mapping.md). # 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: **** 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 {% hint style="info" %} **Note:** The [**Relative redirect**](/geoip-country-redirect/country-redirect/relative-redirect.md) setting must be enabled for the **URL Mapping** functionality to work. {% endhint %}
### 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 - **
### Step 7: Click on Save to apply the changes
{% hint style="info" %} **In case of any queries, please feel free to reach us at** [**help@spicegems.com**](mailto:help@spicegems.com) {% endhint %}