# Multi-lingual Chatbots

Wonderchat supports multilingual websites, allowing you to deploy chatbots that work seamlessly across multiple languages.

{% hint style="warning" %}
**Important:** Chatbots will always reply in the language that the user is speaking in. The language settings discussed in this guide are only for translating fixed messages such as greeting messages, fallback messages, and taglines.
{% endhint %}

## Methods to Set Up Multilingual Chatbots

### Method 1: Multiple Chatbots (One per Language)

The most straightforward approach is to create separate chatbots for each language.

**Benefits:**

* Each language's knowledge base is siloed from others
* Easier to manage if you have dedicated teams for each language
* Complete control over language-specific content
* Embed each chatbot on each language of your website

**Drawback:**

* Requires managing multiple chatbots

### Method 2: Multilingual Feature

{% hint style="warning" %}
**Only available on the Turbo plan**
{% endhint %}

Our built-in multilingual feature allows you to add multiple languages to a single chatbot.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-27e920b36c66bd6a4ccfcda31cfda40e0971f0f5%2FScreenshot%202025-10-30%20at%2015.46.51.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-8d4718cd92eb08ee583f49abde76a0bb5bb88701%2FScreenshot%202025-10-30%20at%2015.47.15.png?alt=media" alt=""><figcaption></figcaption></figure>

Once you’ve added multiple languages, a globe icon will appear in the header bar. Your users can click it to select their preferred language.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-c6356f8f4817d98f4a5b91af0d211a695e357dfe%2FScreenshot%202025-10-30%20at%2015.49.06.png?alt=media" alt=""><figcaption></figcaption></figure>

You can also set a **default (initial) language** in your embed script. This updates a script parameter that defines which language the chatbot loads in by default. For example, you can dynamically set the initial language based on the user’s domain or URL path — ideal for sites with separate language-specific pages or subdomains.\\

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-0f2c3091eb625189ff17ec1b68ca56d828d47a0c%2FScreenshot%202025-10-30%20at%2015.49.47.png?alt=media" alt=""><figcaption></figcaption></figure>

**Features:**

* Configure custom translations for:
  * Chatbot tagline
  * Greeting message
  * Fallback message
  * Other fixed UI elements
* Centralized management

### Method 3: Custom Script Override

You can also customize the greeting parameter directly in the embed script for different language pages, providing another way to manage your greeting messages for different languages

This method is detailed below and allows you to override fixed messages on a per-page basis.

***

### **Customizing Greeting Messages via Script Override**

To configure one chatbot to use a different greeting message based on the page language:

1. Click on **"Embed to Website"**.

<figure><img src="https://3760420285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0WUvfmkdMPXz3x7NXP8i%2Fuploads%2Fgit-blob-b87a176a00ae10e52ff9c80330bf1b2115324e19%2Fimage.png?alt=media" alt=""><figcaption><p>Click on 'embed to website' to modify script settings</p></figcaption></figure>

3. In the embed code, add a `data-greeting` parameter to override the default greeting:

```html
<script 
  src="your-embed-script-url" 
  ...
  data-greeting="Bonjour! Comment puis-je vous aider aujourd'hui?"
></script>
```

4. Use this customized embed code on your language-specific pages.

For example, here is how you can use a French greeting on pages that mainly use the French language.

```jsx

<script
    src="https://app.wonderchat.io/scripts/wonderchat.js"
    data-name="wonderchat"
    data-address="app.wonderchat.io"
    data-id="f12kfnlkjn312321flkqwjenflkqwjenf"
    data-greeting="Hello there!"
    defer
></script>
```

The bot will greet with "Hello there!", but if using the script:

```html
<script
    src="https://app.wonderchat.io/scripts/wonderchat.js"
    data-name="wonderchat"
    data-address="app.wonderchat.io"
    data-id="f12kfnlkjnflkqwjenflkqw21323jenf"
    data-greeting="Bonjour!"
    defer
></script>
```

The bot will greet with "Bonjour", which you can switch this to whichever language in the different language domains of your website.

As long as the greeting message is displayed in the same language of the webpage, your users would be able to interact with the bot in their native language.

***

### **Step 3: Embedding onto your multi-language website**

You can copy and paste the same widget code, and make edits to the script parameter (data-greeting="Hello there!") to reflect the greeting in the language of your choice.

***

## Choosing the Right Method

* **Choose Method 1** if you have dedicated teams for each language and want complete separation of knowledge bases
* **Choose Method 2** if you're on the Turbo plan and want centralized management with proper translation support
* **Choose Method 3** if you want a quick solution using script customization for basic greeting messages

***

If you have any more questions, feel free to reach out to us at <mark style="color:purple;">**<support@wonderchat.io>**</mark>

***


---

# 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.wonderchat.io/setup-guides/setting-up-your-chatbot/setting-up-multi-lingual-chatbots.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.
