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

# Multi-language Surveys

> Create surveys that support multiple languages using translations. This helps you reach a diverse audience without making separate surveys for each language. It also simplifies survey creation, delivery, and analysis for multilingual audiences.

<Note>Multi-language surveys are part of the Feedbackflow </Note>

How to deliver a specific language depends on the survey type (app or link survey):

* App & Website survey: Set a `language` attribute for the user. [Read this guide for App Surveys](#app-surveys-configuration)

* Link survey: Add a `lang` parameter in the survey URL. [Read this guide for Link Surveys](#link-surveys-configuration)

***

## Creating a Multi-language Survey

* Open the **Survey Languages** page in the Feedbackflow settings via the sidebar:

- Click on the **Edit languages** button, to add a new language to your survey

* Select the preferred language from the dropdown and assign an identifier Alias. Click the **Add language** button to add the language to your project.

You can come back to this page anytime to add more languages or remove existing ones.

* Now, return to the dashboard to create a new survey or edit an existing one.

- In the survey editor, scroll down to the **Multiple Languages** section at the bottom and enable the toggle next to it.

* Choose a **Default Language** for your survey.

<Note>Changing the default language will reset all the translations you have made for the survey.</Note>

1. Now, add the languages from the dropdown that you want to support in your survey.

1) You can now see the survey in the selected language by clicking on the language dropdown in any of the questions.

1. You can now translate all survey content, including questions, options, and button placeholders, into the selected language.

1) Once you are done, click on the **Publish** button to save the survey.

## App Surveys Configuration

1. After you setup the Feedbackflow SDK for your user, you can call the `setLanguage` function with the language code. This can be either the ISO identifier or the Alias you set when creating the language. The `language` attribute makes sure that this user only sees surveys with a translation in this specific language available.

```js javascript theme={null}
Feedbackflow.setup({
  environmentId: "<environment-id>",
  appUrl: "<app-url>",
});

Feedbackflow.setLanguage("de"); // ISO identifier or Alias set when creating language
```

<Note>
  If a user has a language assigned, a survey has multi-language activate and it is missing a translation in
  the language of the user, the survey will not be displayed.
</Note>

1. That's it! Now, users with the language attribute set will see the survey in their preferred language. You can start collecting responses in multiple languages and filter them by language on the summary page.

***

## Link Surveys Configuration

For link surveys, the translation delivery is dependent on the `land` URL parameter.

After publishing the survey, just copy the survey link and append the `lang` query parameter with the language alias you have set.

For example, if you have set the alias for French as `fr`, you can share the survey link as

[`https://your-survey-url.com?lang=fr`](https://your-survey-url.com?lang=fr)

Here are two examples:

* English: [https://app.feedbackflowhq.com/s/clptfos2i1pj516pvhxqyu3bn?lang=en](https://app.feedbackflowhq.com/s/clptfos2i1pj516pvhxqyu3bn?lang=en)

* German: [https://app.feedbackflowhq.com/s/clptfos2i1pj516pvhxqyu3bn?lang=de](https://app.feedbackflowhq.com/s/clptfos2i1pj516pvhxqyu3bn?lang=de)

Without the `lang` parameter, Feedbackflow will show the survey in the default language you have set.

You can now start collecting responses in multiple languages!