> ## Documentation Index
> Fetch the complete documentation index at: https://docs.caplena.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Languages and translations

> Run a survey in up to 20 languages. Caplena translates your questions automatically and lets you review and edit every translation.

> [!NOTE]
>
> Surveys is in **closed beta** and not yet available to all customers. [Join the waitlist](https://caplena.com/en/ai-survey-tool) to get access. See [Surveys overview](https://docs.caplena.com/surveys/overview.md) for current limitations.

You write a survey in one **base language** and add more languages. Caplena translates all texts automatically, and respondents get the survey in their browser language.

## Supported languages

English, Spanish, Chinese (Simplified), Chinese (Traditional), German, French, Japanese, Portuguese, Italian, Arabic, Korean, Dutch, Hindi, Indonesian, Russian, Turkish, Polish, Swedish, Thai and Vietnamese.

## Set the base language

The **base language** is the language you write the survey in. Set it with the language setting under the survey name (for example **English**) **before you add questions**. Once the survey has questions, the base language can't be changed.

## Add languages

**Step 1**

In the builder, switch from **Questions** to **Translations**.

**Step 2**

Open **Languages**, select the languages you want to offer and click the add button (for example **Add 2 languages**).

**Step 3**

Confirm with **Add**. All texts are translated automatically from the base language: questions, answer options, labels, the start screen title and the closing message.

![Adding languages](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/languages-menu.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=336ce9278ada3382f221873250d5fd51)

When you edit the base text afterwards, the translations are updated automatically a moment later.

## Review and edit translations

The translations view lists every text with its translation in each language:

![The translations view](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/translations.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=482536f8b8c65e710672cc4b7e1fe51b)

For each text you can:

* **Edit** a translation inline. Edited translations are kept when the base text changes.
* **Mark as reviewed** once you've checked a translation.
* **Original text changed**: shown when the base text changed after a translation was reviewed or edited. Choose **Retranslate** to translate it again, or **Keep mine**.
* **Filter** by language, by reviewed or empty translations, or by changed originals, or show **warnings only**.

### Translation instructions

Use **Translate** → **Translation instructions** to guide all translations, for example terms to keep in English, the form of address, or a maximum length. Then choose:

* **Retranslate reviewed · base changed** to translate again only the texts you've already reviewed whose original has since changed, or
* **Retranslate all** to translate everything again with the new instructions. This overwrites reviewed translations.

![The Translate menu with translation instructions](https://mintcdn.com/caplena-32172960/8VLjyD540Rp1inTq/images/surveys/translate-menu.png?fit=max\&auto=format\&n=8VLjyD540Rp1inTq\&q=85\&s=d5f4e88d8871e9b056ddb9f772b2e140)

You can also ask the agent to fix specific translations. Translations the agent changes are marked as reviewed, and it can mark translations as reviewed on request. Check its changes in the Translations view.

## Which language respondents see

Respondents automatically get the survey in their **browser language** if you offer it. Otherwise they get English if you offer it, and the base language if you don't.

To send a link that opens in a specific language, add `lang` to the link, for example `?lang=de`.

Use the language picker in the builder's **Preview** to check each language.

> [!NOTE]
>
> During the closed beta, buttons, hints and system messages in the respondent interface (such as "N/A" or "Question 2 of \~8") are shown in English, and some texts, such as answer options and the start screen title, may still appear in the base language. Questions and the closing message are shown in the respondent's language. Test each language with the preview before you send the survey out.

## Publishing with translations

Translations are part of the published version. The review blocks publishing while translations are still running or have failed, and warns about translations that are incomplete or outdated.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.