# Translations

The **Translations** tab gathers strings that have to be translated or are language-dependent in other ways, like URLs. This includes all messages, random messages, button labels, carousel titles subtitles, URLs etc.

<figure><img src="/files/V1sKCLAoMNPbropMGn8c" alt=""><figcaption><p>Translations tab.</p></figcaption></figure>

## Translate your blocks

You can add translations to all your blocks by either typing them directly on the platform or exporting and importing them.

{% hint style="info" %}
The lines where translations are missing appear with a red icon next to them.
{% endhint %}

### 🆕 Auto-translate

1. Click on the line that you'd like to change.
2. On the bottom-right corner, click on the **Auto-translate** button.
3. Click **Save.**

<figure><img src="/files/pV1QlOLaCoxb6Srh1CzL" alt=""><figcaption><p>Auto-translate your blocks.</p></figcaption></figure>

### Type or correct your translations

To type translations directly on Chatlayer:

1. Click on the line that you'd like to change.
2. A panel with all the languages opens on the side. Make your changes.
3. Click **Save**.

### By export and import

By clicking the export button in the top, you will receive an email containing a csv file of your translations.

<figure><img src="/files/8hsmToOXHMCL9nL3davf" alt="" width="265"><figcaption></figcaption></figure>

In this CSV, you will find:

* Flow id.
* Block id.
* Block name.
* The component type, each separate component (such as different buttons) has a new row.
* The translation for all of the languages of your bot.

{% hint style="danger" %}
2 things to remember:

* Don't use this export to create new blocks, just to change the translations of existing messages.&#x20;
* The translations of rich text messages will not be included in the export, use the interface to edit those.
  {% endhint %}

#### Good practices

It is recommend to use this export file as a basis for importing the translations. That way you have the correct format and all the ids needed for the import.&#x20;

The recommended steps for importing translations are:

1. Click on **Export** to export translations in the right upper corner.
2. Open de file received per email.
3. Add the translations in the correct column, for example: for Dutch use 'value\_nl' column.
4. Leave the other columns as they are, those are needed for correct processing of the translations and save the file.
5. Use the **Import** button to import these translations, and choose the correct language in the pop-up.
6. Once imported, you will see a pending indicator whilst the import is still running.
7. When this indicator is gone, the import is completed. You can immediately see the translations in the **Translations** tab and you do not need to update the NLP.

{% hint style="danger" %}
Importing / exporting translations will only work in the same bot. To get translations from bot A to bot B, look into importing and exporting [the entire bot](https://docs.chatlayer.ai/bot-answers/settings#bot-import-export).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chatlayer.ai/navigation/bot-builder/translations.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.