---
title: "Map language codes to your custom locale rule"
slug: "map-language-codes-to-your-custom-locale-rule"
updated: 2026-08-11T05:27:04Z
published: 2026-08-11T05:27:04Z
canonical: "support.whatfix.com/map-language-codes-to-your-custom-locale-rule"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.whatfix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Map language codes to your custom locale rule

Advanced customisation enables you to:

- Define unique language identifiers.
- Map recognized language codes to language codes supported by Whatfix as per your preferences.

For example, if your application uses **ch** as the Chinese language code, you can map it to **zh**, the language code for Chinese supported by Whatfix. This ensures that Whatfix recognizes **ch** as Chinese, and provides a localized experience based on your language preferences. For more information, see the [Languages supported by Whatfix](/studio/docs/languages-supported-by-whatfix).

### Prerequisite

Ensure that you have added the required or preferred languages to the Whatfix Guidance dashboard. For more information on how to add a language to the dashboard, see [Add a new language](/studio/docs/adding-a-new-language).

### Steps to map language code to custom locale rule

Use the following steps to map a language code to your custom locale rule:

1. On the Whatfix Guidance dashboard, click **Settings**. ![ia_left_nav_settings](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ia_left_nav_settings.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)
2. Click **Advanced customisation**. ![ia_settings_advanced%20configuration](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ia_settings_advanced%20configuration.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)

1. Click **User rules**. ![click_user_rules](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/click_user_rules.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)
2. Click **Create**. ![set user_create rule.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/set%20user_create%20rule.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)
3. Select **Locale identification**, and then click **Continue**. ![Image](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image-ZTT8NMON.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)
4. Add a **Rule Title**. ![Image](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image-FXNHJO9M.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)
5. In the **Where** section, select where you want the rule to take effect. ![ac_set user_select where.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ac_set%20user_select%20where.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)

> [!NOTE]
> Info:
> 
> Based on where you want the rule to take effect, you can set up any visibility conditions. For example, to enable the rule across all pages of your application, select **All Pages** as type.

1. In the **What** section, click **Language mapping**. ![ac_locale_language mapping.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ac_locale_language%20mapping%281%29.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)
2. Click **Map language**. ![ac_locale_map language.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ac_locale_map%20language.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)
3. In the **Language code** field, enter the language code as recognized by your application. ![ac_locale_enter language code](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ac_locale_enter%20language%20code.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)
4. In the **Language** dropdown, select the language corresponding to the code. ![ac_locale_select language.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ac_locale_select%20language.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)

> [!WARNING]
> Note:
> 
> - To map more language codes, click **Add language code**. ![ac_locale_add language code.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ac_locale_add%20language%20code.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)
> - Only the languages added to the dashboard will be visible in the dropdown. If you have not added a language to the dashboard, you won't see it in the dropdown. For more information on how to add a language, see [Add a new language](/studio/docs/adding-a-new-language).
> - For more information on languages supported by Whatfix, see [Languages supported by Whatfix](/studio/docs/languages-supported-by-whatfix).

1. Click **Save**. ![Image](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image-HA9M24AJ.png?sv=2026-02-06&spr=https&st=2026-10-14T07%3A59%3A54Z&se=2026-10-14T08%3A59%3A54Z&sr=c&sp=r&sig=l%2FtHkBvWOZGXiWH4PyMZXXW5Lho3aLbNrjTNUzvwFdE%3D)