# Make your bot multilingual

{% hint style="info" %}
Find the complete list of languages supported by Chatlayer [here](https://docs.chatlayer.ai/nlp/languages/supported-languages).
{% endhint %}

## Primary vs. extra languages

When [creating a bot](https://docs.chatlayer.ai/start-quickly/leadzy-tutorial/1.-new-bot-new-block#step-1-create-a-new-bot), you first need to choose a **primary language**. This is the language you'll use to develop and configure the bot, including defining messages, button labels, content, links, and logic in inside your [Bot builder](https://docs.chatlayer.ai/navigation/bot-builder).

Once the bot is built, you can add **extra languages**. The structure and logic are defined once and reused across all languages. This means you only need to translate the bot, and any new functionalities or conversational flows will be automatically included in the secondary languages, ensuring a consistent experience.

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FBHRSR0769waT2ZHUnPTn%2FScreenshot%202024-09-03%20at%2009.47.32.png?alt=media&#x26;token=69e55f62-548d-4076-b9e3-8f60fdbe260f" alt=""><figcaption><p>The Bot settings tab.</p></figcaption></figure>

<details>

<summary>Add extra languages to your bot</summary>

To add extra languages to your bot:

1. Under **Settings**, click on [**Bot settings**](https://docs.chatlayer.ai/navigation/settings/settings).
2. Enter extra languages into the **Extra languages** field.
3. Click **Save** on the bottom right corner.

</details>

## Manage a multilingual NLP

When you have created a multilingual bot, you can see all languages' intents and expressions from the [**NLP**](https://docs.chatlayer.ai/navigation/natural-language-processing-nlp) tab.

<details>

<summary>Switch languages inside the NLP tab</summary>

To switch the active language:

1. Go to your any page under your **NLP** tab.
2. Switch language by using the language dropdown on top.&#x20;

</details>

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FvfCNh0pi0NefJwQIzp9r%2FScreenshot%202024-09-03%20at%2009.49.59.png?alt=media&#x26;token=aec17ec5-3b35-4847-b233-346aaced142e" alt=""><figcaption><p>Switch language anywhere inside your NLP tab.</p></figcaption></figure>

Things to remember when managing NLP models in more than one language:

* If you add an intent, the intent will automatically be added to all other languages as well. You can add intents in the primary as well as in the extra languages.
* If you add an expression, the expression is language-dependent and will only be added to the active language model.
* As language models are independent from each other, so you'll have to train and publish them separately. That means that if you make changes in two languages, you will have to [train](https://docs.chatlayer.ai/nlp/natural-language-processing-nlp/train-your-nlp) and [publish](https://docs.chatlayer.ai/publish/publishing-your-bot#id-3.-publish-nlp) both.
* The number of expressions that is displayed under [**Intents**](https://docs.chatlayer.ai/navigation/natural-language-processing-nlp/intents) is the number of expressions for the active language.

<figure><img src="https://2786867680-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FawDLWWkrGBqYaomp6yC9%2FScreenshot%202024-09-03%20at%2009.54.23.png?alt=media&#x26;token=3aee4301-5acd-49e2-8e94-88b9c14440f1" alt=""><figcaption><p>The Expressions tab of a multilingual bot.</p></figcaption></figure>

##


---

# 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/nlp/languages/multilanguage-bots.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.
