> This page is for version Scripted.
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Support multiple languages in the same bot

## Understand multilingual content support\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GV24625GS1EYQ21JPMQHP]

Communicating with your customers in their preferred language makes them
feel like VIPs. Ada lets you do just that! Use your bot's multilingual
functionality to provide that VIP experience to each of your customers.

> **Note**
>
> While Ada offers a variety of languages for communicating with
> customers, the dashboard is always only in English.

There are two translation methods available to you:

* **Automatic translation** – When chatters ask questions in different
  languages, your bot automatically sends your English Answer content to
  Google Translate, then responds with the translated content.

* **Custom translation** – Manually add your own message translations.
  Adding a custom translation to an Answer overrides automatic
  translation for that Answer in that language.

> **Note**
>
> This feature may not be included with your organization's subscription
> package. For more information, see Ada's
> [Pricing](https://www.ada.cx/pricing) page, or contact your Ada team.

### Supported languages\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GVQ4N1VDDPG5VCE8Z35HM]

Ada's multilingual functionality supports the following languages:

<table class="no-borders">
  <tbody>
    <tr>
      <td>
        * Afrikaans
        * Albanian
        * Arabic
        * Belarusian
        * Bosnian
        * Bulgarian
        * Burmese
        * Catalan
        * Chinese (Simplified)
        * Chinese (Traditional)
        * Croatian
        * Czech
        * Danish
        * Dutch
        * English
        * Estonian
        * Filipino (Tagalog)
        * Finnish
        * French
      </td>

      <td>
        * German
        * Greek
        * Haitian Creole
        * Hebrew
        * Hindi
        * Hungarian
        * Icelandic
        * Indonesian
        * Italian
        * Japanese
        * Kazakh
        * Khmer
        * Kinyarwanda
        * Korean
        * Latvian
        * Lithuanian
        * Macedonian
        * Malay
        * Norwegian
      </td>

      <td>
        * Polish
        * Portuguese
        * Punjabi
        * Romanian
        * Russian
        * Serbian
        * Slovak
        * Slovenian
        * Spanish
        * Swahili
        * Swedish
        * Tamil
        * Thai
        * Turkish
        * Ukrainian
        * Vietnamese
        * Xhosa
        * Zulu
      </td>
    </tr>
  </tbody>
</table>

For supported right-to-left languages, the chat is tailored for the best
chatter experience. This includes flipped UI components such as
settings, quick replies, loading bar, etc.

## Turn on multiple language support and automatic translation\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GVYQ2GDTPR020ET8K25T8]

To enable multilingual functionality in your bot, follow these steps:

1. On the Ada dashboard, go to **Settings** > **Bot Setup** >
   **Multilingual**.

2. Under **Available Languages**, select any languages you want your
   bot to be able to send messages in, in addition to English, which is
   always enabled.

3. By default, the **Translate content automatically** toggle is on,
   which allows your bot to serve automatically translated content in
   non-English languages so you don't have to manually translate each
   Answer. For more information on how this toggle works, see the
   [Understand how automatic translations work](/scripted/docs/build-and-maintain-your-bot/personalize-conversations/support-multiple-languages-in-the-same-bot#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GZTZKQVC04DDCGC23DN83)
   section below.

   ![](/_fern-files/_img/07a6974ec796622b9bd59ca4cfc6e51949bb9a638570a5d5b3691d384eb47284.webp)

### Enable only the languages you need\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GW7N0ZV5NN9P0AQRJTEXB]

Tempted to enable every language you possibly can? Hold off! Consider
the following best practices:

* You should only enable languages that your agents speak. Otherwise,
  you might hand off chatters to agents who can't help them.

* For each language you enable, you should have someone on your team who
  speaks that language. That way, they can review your Answer content
  and add custom translations where necessary.

### Understand how automatic translations work\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GZTZKQVC04DDCGC23DN83]

English is the default support language in all Ada bots. You can't
disable it - your bot will always be able to reply to English-speaking
customers. Your bot can always understand chatter questions in any of
Ada's supported languages, regardless of whether they're enabled in your
bot, but can only respond in the languages that are enabled in the
multilingual settings.

If the Answer your bot selects to serve to the chatter has a manual
translation for the chatter's language, your bot always responds with
that manual translation. Otherwise:

* If the **Translate content automatically** toggle is **on**, your bot
  runs your English Answer content through Google Translate and responds
  with the translated content.

* If the **Translate content automatically** toggle is **off**, your bot
  responds with your English Answer content, regardless of the chatter's
  language.

  > **Warning**
  >
  > We always recommend serving content in the same language chatters are
  > writing in. As a result, we don't recommend turning off this toggle.

## Set your bot's starting language\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GWH814S0BQHE65DJ8GPAA]

The starting language is the language your bot starts web chats in. If
most of your customers speak the same non-English language, you can
choose to set it as your bot's starting language. Your bot will
automatically begin every conversation in this starting language, but of
course, chatters can still change the language at any time. The starting
language for all new Ada bots is English.

### Add the language script to Embed2\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GWVMT6EBGCAT2529A42BJ]

You can change the bot's starting language by making a small addition to
the Ada Embed2 script. You might already be familiar with it, but if you
need a refresher, check out our [Embed2 documentation](/scripted/docs/use-ada-with-your-website/deploy-ada-on-your-website-or-app/embed-ada-on-your-website-or-app).
Let's take a look at how to set up a bot's default language to French.

1. Find the default embed script on your webpage. It should look like
   this:

   ```
   <!-- <head> -->
   <script
     id="__ada"
     data-handle="yourbothandle"
     src="https://static.ada.support/embed2.js">
   </script>
   ```

2. To set the bot language, add the following `window.adaSettings`
   snippet between the head and the script of the basic Ada Embed2
   script, and add the language format code from the [ISO 639-1 language format](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).

   ```
   <script>
     window.adaSettings = {
       language: "fr",
     }
   </script>
   ```

   Your revised Ada Embed2 script should look similar to this:

   ```
   <!-- <head> -->
   <script>
     window.adaSettings = {
       language: "fr",
     }
   </script>
   <script
     id="__ada"
     data-handle="yourbothandle"
     src="https://static.ada.support/embed2.js">
   </script>
   ```

## How chatters can change the chat language\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_section-idm4616290486073633339904979906]

Chatters can change the language using one of the following methods:

* **Autodetect** - If a chatter types a message of at least three words
  and 20 characters in an enabled language, the bot will try to identify
  the language and change the language of the chat.

  > **Note**
  >
  > The three word minimum doesn't include common words, such as "and,"
  > "the," etc.

* **Language name** - If a chatter types the exact name of an enabled
  language (e.g., "French" or "Français") into the chat field, the bot
  will change the chat language accordingly. This must be an exact match
  — typos or the name of the language within a longer message (e.g., "Do
  you speak French?") will not trigger a language change.

* **Chat settings** - The chatter can click the **Settings** icon ![](/_fern-files/_img/522a07bd38c8f67de4fb082cd8e614fb9c4df3e9b0dd7b5ea270dc6b2a915b71.webp) to access the chat window settings in Ada's web chat. They can then click **Change language** and select one of the languages you have enabled in your bot.
  in your bot.

## Why didn't my bot switch languages?\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_section-idm4616222962508833339934785103]

There are several specific reasons why your AI Agent might not switch languages as expected:

* **Minimum character and word requirements for Latin-based languages**
  * For messages written entirely in Latin characters, the message must contain at least 3 words (space-separated) and 20 characters to trigger a language switch

  * This requirement applies to all languages except: Greek, Hindi, Japanese, Khmer, Korean, Myanmar, Punjabi, Tamil, Thai, Simplified Chinese, and Traditional Chinese

  * **Switch-disabled language pairs**

  * Some languages are considered too similar by our model, so switching between them is disabled to prevent premature language changes

  * These pairs include:
    * Malay and Indonesian
    * Simplified Chinese and Traditional Chinese
    * Spanish and Catalan
    * Croatian and Serbian

  * **Switch-disabled languages**
    * Once set to these languages, the AI Agent cannot switch out of them through language detection:
      * Haitian Creole
      * Tagalog
      * Bosnian

  * **Non-Latin writing systems**
    * For languages with non-Latin writing systems (like Hindi, Chinese, etc.), we do not support recognizing Latin-based versions of these languages
    * For example, Hindi written in Latin characters (like "kya hal-chal hai") cannot be detected, while the same phrase in Devanagari script (क्या हाल-चाल है) can be recognized

  * **Diacritics requirement**
    * For languages that use diacritics (like Vietnamese), the model requires proper diacritic usage
    * Messages without diacritics may be misidentified (e.g., "voi" without diacritics might be detected as Italian instead of Vietnamese)

  * **Low performance languages**
    * The model has lower accuracy for these languages:
      * Afrikaans
      * Catalan
      * Croatian
      * Haitian Creole
      * Malay
      * Norwegian
      * Slovenian
      * Urdu

  * **Unicode-based detection**
    * For certain languages with unique writing systems, detection is based on Unicode rather than the model
    * This applies when the entire message uses only one of these writing systems:
      * Greek
      * Devanagari
      * Hiragana
      * Katakana
      * Khmer
      * Hangul
      * Myanmar
      * Gurmukhi
      * Tamil
      * Thai

  * **Denied words**
    * Messages containing certain common words across multiple languages will not trigger a switch
    * These words include: "no", "meta", "variable", "swish", "support", "agent", "face", "id", "selfie", "bet", "confirmation", "start", "vacation", "hold", "nya", "fuel", "point", "domain"

## How automatic translations work

With automatic translation activated, your bot does the following:

1. [Determine the language the chatter is writing in](/scripted/docs/build-and-maintain-your-bot/personalize-conversations/support-multiple-languages-in-the-same-bot#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GY36PPQ2BPB8RZ9Z33C86).

2. Identify the best Answer to provide to the chatter.

3. Provide the translated Answer content to the chatter.

   * If the Answer has a custom translation for the chatter's language,
     the bot serves the custom translation.

   * If the Answer doesn't have a custom translation for the chatter's
     language, the bot translates the Answer's content from English to
     the chat language using the Google Translate API and serves
     Google's automatic translation.

You can rely on automatic translations for most scenarios; however, when
your Answers contain non-standard language like brand names, idioms,
slang, industry-specific terminology, etc., you might run into
situations where you prefer to write your own translations. To learn how
to do that, see [Work with custom translations](/scripted/docs/build-and-maintain-your-bot/personalize-conversations/support-multiple-languages-in-the-same-bot#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GYEZQBJ5JGMKBBD2JFH3J).

### How your bot initially determines the chatter's language in Ada's web chat\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GY36PPQ2BPB8RZ9Z33C86]

Your bot adheres to an order of operations when determining the chat
language. It proceeds sequentially through the following criteria to
determine the opening language:

1. **Embed2** - If the Embed2 script defines a default language, the
   bot will always launch in that language. If the language is not set
   in the Embed2 script, it moves on to check the chatter's browser
   language.

2. **Browser** - The bot launches in the chatter's browser language. If
   the bot cannot detect the chatter's browser language, it launches in
   English.

3. **English** - If neither a default language is defined in the Embed2
   script, nor can a browser language be detected, the bot launches in
   English.

> **Warning**
>
> Regardless of how the bot determines the language to use, it can use
> only the languages you’ve enabled in its settings. Be sure to select
> each language you want to support with your bot.

### How your bot initially determines the chatter's language in other channels\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_section-idm4631029404113633676453210522]

Other channels don't have as much information available for your bot to
determine the chatter language. In these cases, the bot just uses Ada's
language detection feature to determine the language the chatter's input
is in.

## Work with custom translations\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GYEZQBJ5JGMKBBD2JFH3J]

If you have automatic translations on, you can preview translations in
your dashboard and modify them if necessary. That way, you can get an
idea if the translated content Google provides is sufficient for your
Answer content, or if you need to enter a custom translation to really
get your content across.

When you include custom translations, the bot overrides the
automatically translated content and provides your custom translations
instead.

### View and modify translated content for an Answer\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_section-idm4631029284793633676461388778]

For Answers that don't have custom translations, you can get a preview
of how Google will translate the content. Then, if you want to modify
the translation, you can do so.

1. Ensure you have enabled all the languages that you want to serve
   translated content for in your bot. For more information, see [Turn on multiple language support and automatic translation](/scripted/docs/build-and-maintain-your-bot/personalize-conversations/support-multiple-languages-in-the-same-bot#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GVYQ2GDTPR020ET8K25T8).

2. On the Ada dashboard, go to **Build** > **Answers**, then open the
   Answer you want to see translated content for.

3. Under **Answer Content**, in the list of your bot's supported
   languages, select the language you want to see content for.

   The non-English languages can have two different headers above them,
   indicating the types of translations you'll see:

   * **Automatic Translations** - Translated content comes directly
     from Google Translate and hasn't been modified at all.

   * **Modified Translations** - This Answer contains custom
     translations and/or modifications to Google's default
     translations.

   ![](/_fern-files/_img/4b8f27783538a7b533ed88bc9d58aa81b285548d9769d9586f1d07fc892603b5.webp)

   If you see that the language you want to use isn't in the list,
   click **Manage Languages** to enable that language in your bot.

4. If the Answer only has automatic translations, click **Modify
   Translation**. The blocks become editable.

   ![](/_fern-files/_img/a8461b91a6f17bf8efe62211c6c9d3770959705eb3584656c11546f1bf0dab8e.webp)

   If the Answer already has custom translations, the blocks are
   editable as soon as you open the Answer.

5. Modify the translation as required and click **Save**. If the Answer
   didn't have any custom translations before, the language now appears
   under **Modified Translations** in the list of supported languages
   for this Answer.

   ![](/_fern-files/_img/423b75ec86e58a58e1aca2c8d0e20178c6b6cf7c84458f411451b2536a51df25.webp)

### Remove a custom translation from an Answer\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GZ1VZ6PWGSNNC319JK3J4]

To delete a custom translation from an Answer:

1. On the Ada dashboard, go to **Build** > **Answers**, then open the
   Answer you want to see translated content for.

2. Under **Answer Content**, in the list of your bot's supported
   languages, select the language you want to delete the custom
   translation for.

3. Click **Delete modifications**. Then, in the confirmation window
   that opens, click **Delete**.

   * If you have automatic translations turned on for your bot, your
     bot will go back to serving automatically translated content to
     chatters.

   * If you don't have automatic translations turned on for your bot,
     your bot will serve English content for this Answer to chatters.

   ![](/_fern-files/_img/79694e34fcd7ebbcc2f512c867c67bffdcac8785d284668ff682652b8895eba3.webp)

### Translate quick reply buttons\[#UUID-8604b076-6ac5-26e7-2da3-c5c5bd8af5e6_id_360018374134_id_h_01G05GZB5NAW1XYKNM6G11JKN2]

You can use the [Quick Replies block](/scripted/docs/build-and-maintain-your-bot/work-with-blocks-and-apps/let-chatters-advance-to-other-answers-with-the-quick-replies-block)
to add quick reply buttons to the bottom of an Answer. These buttons act
as links that trigger other Answers.

You can rely on automatic translations for quick reply button text or
add custom translations if you prefer. The table below shows how these
button titles will be translated depending on the Answer's settings.

| Answer Label custom translation provided? | English Answer Label provided? | Quick reply button text                |
| ----------------------------------------- | ------------------------------ | -------------------------------------- |
| Yes                                       | N/A                            | Answer Label custom translation        |
| No                                        | Yes                            | Answer Label automatic translation     |
| No                                        | No                             | Answer **Title** automatic translation |

Quick reply button text is automatically translated unless a custom
translation is provided. To add a custom translation for a quick reply
button:

1. In the Answer editor, click **Options** > **Answer settings**.

2. Beside the **Answer Label** heading, click **Add**.

3. Select the language you want to translate the Answer Label to. This
   list is populated from the languages that are enabled in your bot.

4. After you select the language, an additional Answer Label field
   appears. Input the custom translation for this Answer's quick reply
   button.

5. Click **Save**.

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).