---
title: Translate URLs
slug: configured-commerce/docs/translate-urls
createdAt: 2026-08-13T10:46:29.000Z
---

When working with multi-language content, provide URLs in the same language as the website to improve the overall customer experience. The URL can be customized to display the translation at the Category Root, the Category URL, the Product URL, or all three:

- [www.sitename.com/categoryroot/categoryURL/productURL](http://www.sitename.com/categoryroot/categoryURL/productURL)

Aside from the initial setup, done manually in the Admin Console, creating translatable URLs for Products and Categories is most often accomplished through a Product integration job.

It is important to note that translating URLs will not result in a duplicate content penalty when considering Search Engine Optimization (SEO).

## Set up

All steps within this article are performed within the Admin Console.

### Settings

Two Settings are involved in translating URLs:

- Catalog Root Path
- Product Canonical Root Path

Find these Settings in the Admin Console: **Admin Console** > **Administration** > **Settings** > **Catalog** > **URLMapping** section, or search using the search bar.

The same **URL Mapping** section has a **Use Home Page Url Segment Across Catalog Pages** setting. When enabled, the website's Home Page Url Segment is added to all catalog pages (product list, product detail, brand, and search results pages), not just content pages, so a multilingual site can use a single, unified language segment (for example, `domain/en/...`) across the whole site instead of adding language indicators to each Root Path setting individually. This setting is website-specific and is turned on by default for new websites; it is turned off by default for existing websites to avoid changing their current URLs.

:::hint{type="info"}
**Note**

After changing this setting, clear the Admin Console cache (and the browser cache, if needed) to see the updated URLs on the storefront.
:::

:::hint{type="info"}
**Note**

Translated URLs will only display when text is provided for the default language for the Catalog and Product Settings listed above.
:::

### Modify the root URL in the translation dictionary

:::hint{type="info"}
**Note**

You must have translated values for the Catalog Root Path, Product Canonical Root Path, and Brands Root Path settings to support catalog `hreflang` attributes. Each permutation between a setting and a language must be unique to support displaying the correct language to search engine crawlers.
:::

1. Go to the **Settings** listed above and enter the desired default language text.
2. Go to **Administration** > **Localization** > **Translation Dictionary**
3. Use the **Keyword** search and search for "root".
4. **Catalog\_UrlRoot** and **Product\_UrlRoot** should display. If not, click **More Options** and select **Generate Records**.
5. For both **Catalog\_UrlRoot** and **Product\_UrlRoot**, click **Edit** and enter the translation into the **Translation** field.

## Product and category URL translation

### Modify the product URL translation

1. Go to **Catalog** > **Products.**
2. Find the desired Product.
3. Click **Edit**, then select the **Field Translation** icon next to the **URL Segment** field.
4. Enter the translated text for the desired language.

### Modify the category URL translation

1. Go to **Catalog** > **Categories**
2. It may be necessary to select the appropriate website from the website selector menu.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/UeiaAroIs9TYu4zcUm3Pp-20260720-144709.png)
3. Find the **Category** associated with the previously modified Product.
4. Click **Edit**, then select the **Field Translation** icon next to the **URL Segment** field.
5. Enter the translated text for the desired language.

When these steps are completed, rebuild the search index. Go to **Marketing** > **Search** > **Indexing**, and click **Rebuild All**.

## View the translated URLs on the website

1. Go to the website.
2. Change the displayed language to the desired language using the language drop-down.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/4WgXWQek3kFZ5M74bhisj-20260720-144709.png)
3. Go to the modified product.
4. Translations for root path, category URL segment and product URL segment display for the selected language.