> For the complete documentation index, see [llms.txt](https://docs.truedat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.truedat.io/v8.8/administration/language-management.md).

# Language management

## Set up new languages

Truedat is available in English and Spanish by default. You can also set up other languages. To do so, go to **Administration** → **Translations/Languages** → **Manage**.

<figure><img src="/files/UPWh64QEasTVlcUKnMld" alt=""><figcaption></figcaption></figure>

When you add a language, all messages and texts are copied from the default language. Update them with translations for the new language.

Truedat displays text in the user's browser language. If that language is not configured, it uses the default language.

## Customise texts

As an administrator, you can customise most text in Truedat. This includes menu options, labels, messages, and icons. Go to **Administration** → **Translations** to view all customisable text in the available languages.

<figure><img src="/files/RYmnRDlWMiJtQISG4AlR" alt=""><figcaption></figcaption></figure>

### Modify an existing text

To modify existing text, find it using the search box. Select the **Definition** and edit it. You can add a description or note for the message. Changes apply immediately and appear on the website. For example, change “concept” to “term” by searching for “concept”. Then update the definitions in the results.

<figure><img src="/files/ofbFnHHMBKe0AdJiGHWI" alt=""><figcaption></figcaption></figure>

### Create a new text

To create text, select **Create Message**. Complete the form with the Message ID, text for each language, and an optional description or note.

<figure><img src="/files/2asK6hFak8NCHb5lXFXz" alt=""><figcaption></figcaption></figure>

### Customise menu texts

The menu texts can be customised as follows:

The Message ID follows this pattern: "sidemenu.*\[name of the menu option]*". Search for “sidemenu”, then update the **Definition** for the menu option.

<figure><img src="/files/ju3W8GBBJhpur3UI6D7G" alt=""><figcaption></figcaption></figure>

### Customise menu icons

The menu icons can be customised as follows:

The Message ID follows this pattern: "sidemenu.*\[name of the menu option].*&#x69;con".

* sidemenu.admin.icon
* sidemenu.ai.icon
* sidemenu.catalog.icon
* sidemenu.dashboards.icon
* sidemenu.glossary.icon
* sidemenu.grants.icon
* sidemenu.ingest.icon
* sidemenu.lineage.icon
* sidemenu.members.icon
* sidemenu.quality.icon
* sidemenu.qx.icon
* sidemenu.search.icon
* sidemenu.taxonomy.icon

The **Definition** contains the icon name. Choose an icon from [Semantic UI React](https://react.semantic-ui.com/elements/icon/).

<figure><img src="/files/yEIhpTyxlL5VQwatGSVr" alt=""><figcaption></figcaption></figure>

### Customise page header icons

The page header icons can be customised as follows:

The Message ID follows this pattern: "*\[name of the page].*&#x68;eade&#x72;*.*&#x69;con".

* Glossary pages:
  * concepts.header.icon
  * conceptsUpload.header.icon
  * domains.header.icon
* Data Catalog pages:
  * structureType.header.icon
  * structureTypes.header.icon
  * bulkUploadEvents.header.icon
  * grant.header.icon
  * structuresGrant.header.icon
  * referenceDatasets.header.icon
  * pendingStructureNotes.header.icon
  * tag.header.icon
  * tags.header.icon
  * lineage.events.header.icon
  * task.header.icon
* Data Quality pages:
  * implementations.header.icon
  * quality.header.icon
* Task automation pages:
  * ai.actions.header.icon
  * ai\_sandbox.header.icon
  * prompts.header.icon
  * providers.header.icon
  * resourceMappings.header.icon
* Members pages:
  * group.header.icon
  * role.header.icon
  * roles.header.icon
  * user.password.header.icon
  * users.header.icon
* Administration pages:
  * templates.header.icon
  * hierarchies.header.icon
  * relationTags.header.icon
  * i18n.header.icon
  * elastic\_index.header.icon
  * subscriptions.header.icon
  * configurations.header.icon
  * jobs.header.icon
  * sources.header.icon

### Customise filter fields

You can use template fields to filter searches. By default, each filter displays its template field name. To display more meaningful text, create a message with the appropriate text.

The Message ID follows this pattern: filters.*\[name of the field in the template]*

The **Definition** contains the displayed text.

Example: A template field is named `basic_list`. To display “Basic list” instead, create the appropriate message.

<figure><img src="/files/OAg31FiVBHEgj0wf9Iog" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/hrSxpODzcpWwcbgkOeOi" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OX9gPGif0Ou5B1O11Li2" alt=""><figcaption></figcaption></figure>

### Customise values of filter fields

You can also customise values displayed in a filter. This applies when a template field uses a list of values.

The Message ID follows this pattern: filters.*\[name of the field in the template].\[value from the template]*

The **Definition** contains the displayed text.

Example: A template field named `basic_list` has the values 1, 2, 3, and 4. To display “First” instead of “1”, create the appropriate message.

<figure><img src="/files/J6e77njD2lKHCl1TARKp" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/wj620puYvqeo7o7UBZZM" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/oucwFtrCuEKXoLBnbDJ1" alt=""><figcaption></figcaption></figure>

### Create a structure type icon

You can customise icons associated with structure types using a message.

The Message ID for a structure type icon follows this pattern: "structure.type.*\[structure type]*.icon". To customise an icon by field type, such as string, numeric, or boolean, use: "structure.type.*\[field\_type]*.icon".

The **Definition** contains the icon name. Choose an icon from [Semantic UI React](https://react.semantic-ui.com/elements/icon/).

<figure><img src="/files/m9TNIjzml37jD0alhbzu" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/DMmS3m5cki6vZ1YueyD5" alt=""><figcaption><p>Create a new Message ID and enter the icon name “folder” as its definition.</p></figcaption></figure>

<figure><img src="/files/kaQsON5ijNplirkY4F6C" alt=""><figcaption></figcaption></figure>

### Share button for concepts and structures

Use the following messages to customise Share icons:

* shareLink.concepts.icon
* shareLink.structures.icon

The **Definition** contains the icon name. Choose an icon from [Semantic UI React](https://react.semantic-ui.com/elements/icon/).

<figure><img src="/files/fOrcwdhyrk5BL0VhYF83" alt=""><figcaption></figcaption></figure>

### Translate template fields

Use the following messages to localise template labels, field group names, fields, and values:

* templates.{label}
* templates.groups.{group\_name}
* fields.{label}
* fields.{label}.{value}

{% hint style="info" %}
For **Dropdown** → **Key/value list** fields, use the value, not the key, in the translation message.
{% endhint %}

<figure><img src="/files/B9Rebn0VkQiRuVzt0okr" alt=""><figcaption></figcaption></figure>