---
# System prepended metadata

title: Language translation revamp

---

# Language translation revamp

---
title: Multilingual and language translation support
sidebar_label: Multilingual and language translation support
---


Yellow.ai lets you add multiple languages to your bot to communicate with your customers in their preferred language. This feature makes it easy for businesses to expand globally and engage with customers in their desired language. Users can seamlessly switch between languages during their conversations with the bot, resulting a personalized experience that caters to their unique needs. 

For example, if your bot is programmed to greet users with a welcome message, it will display **Greetings, welcome to India**. However, to create a more personalized experience, you can utilize the translation feature to translate the word **Greetings** into different languages. For instance, in Hindi, the word **Greetings** can be translated to **Namaskar**, while in Tamil it can be translated to **Vanakam**. By configuring these translations, users can add a human touch to the bot's communication, creating a more engaging and welcoming experience for their customers.


## 1. Supported languages

The following table consists of the languages supported in our platform.


| Language                      | ISO 639-1 code    | Full Support (Text) | Speech-to-text | Text-to-speech | Knowledge Mining | Sentiment Analytics | Small Talk Support | Using Translation (Text) |
| ----------------------------- | --- | ------------------- | -------------- | -------------- | ---------------- | ------------------- | ------------------ | ------------------------ |
| English - US                  |  en   | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| English - Great Britain       |   en  | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| English - Canada              |   en  | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| English - India               |    en | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| English - Australia           |  en   | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| English - Singapore           |  en   | Yes                 |                |                | Yes              |                     |                    |                          |
| English - Nigerian Pidgin     |   en  | Yes                 |                |                | Yes              |                     |                    |                          |
| English - South Africa        |  en   | Yes                 |                |                | Yes              |                     |                    |                          |
| Chinese - Cantonese           |     | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| Chinese - Simplified          | zh-cn    | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| Chinese - Traditional         |    | Yes                 |                |                | Yes              | Yes                 | Yes                |                          |
| Arabic (Peninsular Group)     |   ar  | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| Arabic (Mesopotamian Group)   |  ar | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| Arabic (Levantine Group)      |  ar  | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| Arabic (Egypto-Sudanic Group) |  ar  | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| Arabic (Maghrebi Group)       |  ar | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| Afrikaans                     |   af  | Yes                 | Yes            | Yes            | Yes              | Yes                 | Yes                |                          |
| Albanian                      |   sq | Yes                 |                |                | Yes              | Yes                 | Yes                |                          |
| Amharic                       | am  | Yes                 |                |                | Yes              | Yes                 | Yes                |                          |
| Armenian                      |   hy  | Yes                 |                |                | Yes              | Yes                 | Yes                |                          |
| Aymara                        |     | Yes                 |                |                | Yes              | Yes                 | Yes                |                          |
| Azerbaijani                   |   az  | Yes                 | Yes            |                | Yes              | Yes                 | Yes                |                          |
| Basque                        |   eu | Yes                 | Yes            |                | Yes              | Yes



## 2. Add languages to your bot

To add a new language to your bot, follow these steps:

1. Go to **Studio** and click the **Language** icon.

![](https://hackmd.io/_uploads/SkFZyOUVh.png)


2. Click **+ Add langauge**

![](https://hackmd.io/_uploads/ByzL1_U43.png)


3. Add the required languages and click **Save**. 

![](https://i.imgur.com/AL5YsQg.png)

## 3. Language translation

These sections will guide you in setting language translations for your bot.

### 3.1 Set language translation for your bot

1. Go to **Studio** > **Translations**.

![](https://hackmd.io/_uploads/HyvAyOLNn.png)

2. Click **+ Create new key**.

![](https://hackmd.io/_uploads/HypGg_LVh.png)


3. In the following pop-up, fill the below-mentioned fields:

 *  In **Key** enter the keyword that will switch the language.
 * Describe the keyword in the **Description** field.
 * Add the translated lines in the required languages.

![](https://i.imgur.com/04wtZLQ.jpg)


6. Click **Add**. 

You can add multiple keys and lines as per your requirement.

An alternative to manually filling each field with translated data in different languages is to use the **Auto translate** option located at the top right corner. This option automatically populates the empty fields with translated data, provided the corresponding field in English is already filled with data.

![](https://hackmd.io/_uploads/BJJ6bd8Vh.png)


### 3.3 Add multiple translations at once

To add multiple translations at the same time, follow these steps:

1. Click **Bulk Manage** > **Import**.

![](https://i.imgur.com/6GhFAom.png)

:::note
**Bulk Manage** > **Export** is used to download the existing keys in your platform along with their translations.
:::

2. Have a CSV file ready with mandatory columns: **name** (key), **english_text**. This can be followed by the other configured languages (columns) like **hindi_text**, **kannada_text**, **tamil_text**, etc.
3. Click **Upload File**, select the CSV file from your local system to import the file. 
4. Click **Import**. 

<img  src="https://i.imgur.com/BIj6OLQ.png"  alt="drawing"  width="70%"/>

### 3.4 Add translations using code

Translation can also be configured via code. 

1. Go to **Functions** and click the transalte icon.
2. Click **+ Add code**, and then add the following line to the **Code** field, along with the default message in the required language to the **Message** field.
3. Click **Add Message**.

```app.renderMessage('code-goes-here', {}, 'default message')```


![](https://i.imgur.com/VCQyjt8.jpg)

When the bot encounters the message specified in the Message field, it automatically executes the code, performing translation in the chosen language.

---

## <a name="2"></a> 4. Configure translation in nodes

To enable the translation feature and allow nodes to switch to the required language, you need to configure the nodes accordingly. Here are the steps to configure translations in nodes:

1. Click the translation icon in the text field.

![](https://i.imgur.com/Bzlt66X.png)

2. Select the [Key](https://) that is already configured for that text translation (or, [add new translations](https://) as you create each node).

![](https://i.imgur.com/wmSwZYu.png)

When the bot-user conversation reaches this node, based on the language used by the customer, the bot automatically switches to the language configured in the key.