Skip to content
Open Screeb

Translate your surveys and choose the display language

Pick the languages of your workspace, translate a survey in the builder, and control which language each user sees, including from your code.

How-to3 min read, updated Oct 15, 2026

Show each user the survey in their own language. You choose the languages of your workspace, translate each survey in the builder, and Screeb picks the language for each user when the survey shows.

  • Your role lets you edit surveys. Changing the workspace languages also needs the permission to update the organization settings.
  • The language menu of the builder is available for surveys only.
  1. Open Language & translation, in the survey group of the settings menu.
  2. In Survey languages, add or remove languages. Keep between 1 and 20.
  3. Click Save.
The Language settings page, with two survey languages selected

These languages are offered in the builder of every survey.

  1. Open the survey and click Build.
  2. Open the language menu in the toolbar above the questions. Each language shows its state: Default for the default language, the number of missing questions, or Complete.
  3. To translate automatically from the default language, click Translate on a language, or Translate missing questions at the bottom of the menu for all of them. Only the missing questions are translated.
  4. To review or write a translation yourself, click the language in the menu. The builder now shows and edits the texts in that language. Click a question to change its text.
  5. Switch back to the default language when you are done.
The language menu of the builder, with the default language, a language with missing questions and its Translate button

More actions in the menu:

  • Add a language opens the workspace language settings.
  • The menu of a language row offers Set as default, Retranslate all questions, which replaces your manual edits in that language, and Remove translation, which deletes every text in that language.

The default language is the fallback for every user. If the builder warns “Missing translation in the default language”, fill in the missing texts in the default language before you launch.

When a survey starts for a user, Screeb takes the first language available in this order:

  1. The language your code passes when it starts the survey.
  2. The language your code passes when it loads Screeb.
  3. The language user property of the user.
  4. The language of the user’s browser or device.

If the survey has no translation in that language, it shows in its default language. A text missing in the chosen language also falls back to the default language. A user who resumes a response keeps the language of that response.

To show a survey only to users of a given language, add the Language rule in Choose who sees your survey.

Your developers can force the language with the JavaScript tag. Use a two-letter language code such as en or fr:

  • For one survey, when they start it: $screeb("survey.start", "<SURVEY_ID>", { language: "en" });
  • For every survey and message, when they load Screeb: $screeb("init", "<WEBSITE_ID>", { language: "en" });
  • For one user, by setting their language property: $screeb("identity.properties", { language: "en" });

Messages accept the same option with message.start. The mobile SDKs have the same options, see the developer docs.

Each user sees the survey in the best language available, and the responses keep the language they were given in, so you can filter on it.

A user sees the default language. The survey has no translation in their language, or a higher-priority setting forces another one. Check the language property on their profile and the options in your code.

A language is missing from the builder menu. Add it to the workspace languages first.