---
title: "Module Translate Settings"
slug: "module-translate-settings"
updated: 2025-09-26T12:40:05Z
published: 2025-09-26T12:40:05Z
canonical: "docs.unqork.io/module-translate-settings"
---

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

# Module Translate Settings

UDesignerClassic Designer

As you build applications, you might need to deliver them in a language other than English. The **Module Builder****'s Translate Settings** let you translate the front-end of your application. You can easily set up translations that display based on the end-user's location (determined by the data.currentUser.locale value). You can add translations for many elements, including component names, helper text, error messages, and so on. We'll also show you how to add translations for elements created using Content components.

> To learn more about general component settings, view our [General Component Settings](/v1/docs/general-component-settings) article.

## Enabling the Module Translate Settings

The first step to set up translations in any [module](/v1/docs/introduction-to-the-module-builder) is to enable the Module Builder Translate Settings.

To enable translations for a module in the UDesigner, continue as follows:

1. Open your module in the Module Builder.
2. From the top right of the page, click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/image(33).png?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D) (**ellipsis**) button to display the Module Header Settings.
3. From the drop-down, click **Translations**. A new page opens in the browser.
4. In the left side menu, select ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/ModEditor_Translate.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D) (**Translate**) and set the **Enable Translations** toggle to ![A toggle switch indicating an on/off state for a user interface element.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Group 1.png?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D) (ON) [![A static image displaying out to enable Module Editor Translations.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module_Translate_Enable_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module%20Translate%20Enable.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)
5. Scroll to the bottom of the page and click Save Translations.

In the Translate table, you can see all languages supported in your environment. Next, you'll learn how to add languages to your environment to be used in your modules.

## Adding Languages to Your Environment

When Unqork sets up client environments, we add a **Locale** module to each environment. You can access this Locale module in your environment's Library Elements. Use the Locale module to add languages to the Translate Settings Translate table. Languages added to the Locale module appear in the Translate table of every module in your environment.

> [!NOTE]
> Contact your Unqork rep if you can't locate your Locale module or if it's been deleted.

> [!NOTE]
> Be sure to add any languages you want to support to the Locale module in your environments. If not, you can lose translations when promoting between environments. Say you promote a module with French and Japanese translations to an environment only set up to support French. You'd lose your Japanese translations in the new environment.

To add a language to your environment:

1. Navigate to the **Workspaces** page of your environment. Or, open a module.
2. In the top right menu of the page, from the **Library ▾** drop-down, select **Library Elements**.
3. Locate the **Locale** module.
4. From the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/image(33).png?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D) (**ellipsis**) button to the right of the tile, select **Preview**. The module opens in Express View.

[![A static image displaying how to preview the Locale module in Express View.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module_Translate_PreviewLocale_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module%20Translate%20PreviewLocale.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)
5. In the **Language** field, enter the name of the language. For example, `French`.
6. In the ISO 639-1 field, enter the language's **ISO 639-1** code. For example, `fr` for French.

> You can find a ISO 639-1 language code list at the following link: [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).
7. Click **Save**. The specified language now appears as a column in the Translate table.

## Adding Translations to a Module

[![A static image displaying how to create a new language with its ISO 639-1 abbreviation.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module_Translate_Locale_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module%20Translate%20Locale.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)

So far, you've seen how to enable translations and set up target languages. Now you're ready to start adding translations to your modules. You'll add your translations for a given module in that module's Translate table. Each module's Translate table auto-populates with translatable items in that module. These items appear as individual rows in the English column of the Translate table.

Here are a few tips on adding translations:

- Don't enter translations for elements invisible to end-users. For example, [Hidden](/v1/docs/hidden-component) components or hidden fields.
- Use a spreadsheet to make the process of adding translations easier. Copy and paste your Translate table into a spreadsheet. Then, add translations to the spreadsheet. When ready, copy and paste your spreadsheet to the Translate table.
- The default component error message does not auto-populate in the Translate table. You must manually adjust your component's default error messages for the message to display in the Translate table.

To add translations to the Translate table:

1. Open your module in the Module Builder.
2. From the top right of the page, click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/image(33).png?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D) (**ellipsis**) button to display the Module Header Settings.
3. Click the Translations options from the drop-down.
4. In the left side menu, select ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/ModEditor_Translate.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)(**Translate**).
5. In the Translate table, find the element you want to translate.
6. In the Translate table, enter translations for each element in the same row and its respective language column. For example, translating the English word **Next** to the Spanish word **Siguiente**.

[![A static image displaying an example of how the Translate Settings Translate table might look.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module_Translate_Table_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module%20Translate%20Table.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)
7. Scroll to the bottom of the page and click **Save Translations**.

As you build applications, you might need to deliver them in a language other than English. The **Module Builder****'s Translate Settings** let you translate the front-end of your application. You can easily set up translations that display based on the end-user's location (determined by the data.currentUser.locale value). You can add translations for many elements, including component names, helper text, error messages, and so on. We'll also show you how to add translations for elements created using [Content](https://docs.unqork.io/Content/A04-ModEditor-Display_Layout/A04002A-Content_Component.htm) components.

## Enabling the Module Translate Settings

The first step to setting up translations in any [module](/v1/docs/introduction-to-the-module-builder) is enabling the Module Builder Translate Settings.

To enable translations for a module:

1. Open your module in the Module Builder.
2. From the top right of the page, click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/image(33).png?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D) (**ellipsis**) button to display the Module Header Settings.
3. Click the Translations options from the drop-down.
4. In the left side menu, select![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/ModEditor_Translate.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)(**Translate**) and set the **Enable Translations** toggle to ![A toggle switch indicating an on/off state for a user interface element.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Group 1.png?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D) (ON).

[![A static image displaying out to enable Module Editor Translations.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module_Translate_Enable_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module%20Translate%20Enable.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)
5. Scroll to the bottom of the page and click **Save Translations**.

In the Translate table, you can see all languages supported in your environment.

Next, you'll learn how to add languages to your environment to be used in your modules.

## Adding Languages to Your Environment

When Unqork sets up client [environments](https://docs.unqork.io/Content/A00-Unqork_Platform/A00102-Workspaces_Env_Level.htm), we add a **Locale** module to each environment. You can access this Locale module in your environment's Library Elements. Use the Locale module to add languages to the Translate Settings Translate table. Languages added to the Locale module appear in the Translate table of every module in your environment.

> [!NOTE]
> Contact your Unqork rep if you can't locate your Locale module or if it's been deleted.

> [!NOTE]
> Be sure to add any languages you want to support to the Locale module in your environments. If not, you can lose translations when promoting between environments. Say you promote a module with French and Japanese translations to an environment only set up to support French. You'd lose your Japanese translations in the new environment.

To add a language to your environment:

1. Navigate to the **Workspaces** page of your environment. Or, open a module.
2. In the top right menu of the page, from the **Library ▾** drop-down, select **Library Elements**.
3. Locate the **Locale** module.
4. From the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/image(33).png?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D) (**ellipsis**) button to the right of the tile, select **Preview**. The module opens in Express View.

[![A static image displaying how to preview the Locale module in Express View.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module_Translate_PreviewLocale_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module%20Translate%20PreviewLocale.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)
5. In the **Language** field, enter the name of the language. For example, `French`.
6. In the ISO 639-1 field, enter the language's **ISO 639-1** code. For example, `fr` for French.

> You can find a ISO 639-1 language code list at the following link: [https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).

7. Click **Save**. The specified language now appears as a column in the Translate table.

## Adding Translations to a Module

[![A static image displaying how to create a new language with its ISO 639-1 abbreviation.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module_Translate_Locale_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module%20Translate%20Locale.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)

So far, you've seen how to enable translations and set up target languages. Now you're ready to start adding translations to your modules. You'll add your translations for a given module in that module's Translate table. Each module's Translate table autopopulates with translatable items in that module. These items appear as individual rows in the English column of the Translate table.

Here are a few tips on adding translations:

- Don't enter translations for elements invisible to end-users. For example, [Hidden](/v1/docs/hidden-component) components or hidden fields.
- Use a spreadsheet to make the process of adding translations easier. Copy and paste your Translate table into a spreadsheet. Then, add translations to the spreadsheet. When ready, copy and paste your spreadsheet to the Translate table.
- The default component error message does not auto-populate in the Translate table. You must manually adjust your component's default error messages for the message to display in the Translate table.

To add translations to the Translate table:

1. Open your module in the Module Builder.
2. From the top right of the page, click the ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/image(33).png?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D) (**ellipsis**) button to display the Module Header Settings.
3. Click the Translations options from the drop-down.
4. In the left side menu, select ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/ModEditor_Translate.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)(**Translate**).
5. In the Translate table, find the element you want to translate.
6. In the Translate table, enter translations for each element in the same row and its respective language column. For example, translating the English word **Next** to the Spanish word **Siguiente**.

[![A static image displaying an example of how the Translate Settings Translate table might look.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module_Translate_Table_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Module%20Translate%20Table.jpg?sv=2026-02-06&spr=https&st=2026-11-15T03%3A50%3A46Z&se=2026-11-15T04%3A50%3A46Z&sr=c&sp=r&sig=SnA4wYfODXxFRlmf%2BT%2FpvaXz%2FFauUd2RQz3T%2BzmB%2FeM%3D)
7. Scroll to the bottom of the page and click **Save Translations**.

## Resources

- [Google Translate Integration template](/v1/docs/google-translate-integration-template)
- [Translation Header snippet](/v1/docs/translation-header-snippet)
- [Workflow Translate Settings](/v1/docs/workflow-translate-settings)

End-users, also known as Express Users, are the individuals accessing an application through Express View. In most cases, end-users are the customers using the product.

Express View is how your end-user views your application. Express View also lets you preview your applications to test your configuration and view the styling. This is also the view your end-users will see when interacting with your application. After configuring a module, click Preview in the Module Builder to interact with the module in Express View.

ISO 639 is a standardized nomenclature used to classify languages. For ISO 639-1, each language is assigned a two-letter abbreviation. For example, fr for French.