---
title: "Map language codes to your custom locale rule"
slug: "map-language-codes-to-your-custom-locale-rule"
updated: 2026-02-25T07:39:10Z
published: 2026-02-25T07:39:10Z
---

> ## 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){target=`_blank`}. 

### 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){target=`_blank`}. 

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

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

{{snippet.click_settings_ac}}

3. Click **User rules**.
![click_user_rules](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/click_user_rules.png){height="" width="500"}

4. Click **Create**.
![set user_create rule.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/set%20user_create%20rule.png){height="" width="500"}

5. Select **Locale identification**, and then click **Continue**.
![Image](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image-ZTT8NMON.png){height="" width="500"}

6. Add a **Rule Title**.
![Image](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image-FXNHJO9M.png){height="" width="500"}

7. 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){height="" width="500"}

:::(Info) (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.
:::

8. 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){height="" width="500"}

9. Click **Map language**.
![ac_locale_map language.png](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/ac_locale_map%20language.png){height="" width="500"}

10. 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){height="" width="500"}

11. 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){height="" width="500"}

:::(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){height="" width="500"}

- 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){target=`_blank`}. 

- For more information on languages supported by Whatfix, see [Languages supported by Whatfix](/studio/docs/languages-supported-by-whatfix){target=`_blank`}.
:::

12. Click **Save**.
![Image](https://cdn.document360.io/a268766e-d74d-4619-9613-e2472f809ffb/Images/Documentation/image-HA9M24AJ.png){height="" width="500"}