Skip To Content

Multiple language support

Including one or multiple sets of translations for your surveys can make it easier for both data collectors and respondents to understand your survey questions.

Translate survey questions

The process for including translations for your survey questions in Survey123 for ArcGIS is as follows:

  1. Add a column to your survey worksheet and name it label:: followed by the name used to identify the language. While the name of the language will work, for example, label::EspaƱol, it's recommended that you instead use the two-character locale code, for example, label::es.
    Note:

    For information on a specific language's local codes, see Wikipedia's List of ISO 639-1 codes. However, keep in mind that not all of these languages are supported by Survey123.

  2. For each question to be translated, enter the translated text directly in this column.
  3. Repeat for each additional language.

Create a label column for each language

Translate hints and constraint messages

Hints are translated the same way as labels.

  1. Add a column to your survey worksheet and name it hint:: followed by the name or locale code used to identify the language, for example, hint::es.
  2. For each hint to be translated, enter the translated text directly in this column.
  3. Repeat for each additional language.

Create a hint column for each language

The constraint message that displays when a constraint is not adhered to can also be translated, with a column such as constraint_message::es.

Translate choice lists

You can also provide translations for the options in your choice lists.

  1. Add a column to your choices worksheet and name it label:: followed by the name or locale code used to identify the language, for example, label::es.
  2. For each option to be translated, enter the translated text directly in this column.
  3. Repeat for each additional language.

Create a label column for each language

Translate images and media

Translated images can also be provided across languages.

  1. Add a column to your survey or choices worksheet and name it image:: followed by the name or locale code used to identify the language, for example, image::es.
  2. For each image to provide a translation for, place the translated image in the survey's media folder, and enter its file name in the new column.
  3. Repeat for each additional language.
Create an image column for each language

Audio files attached to a question or choice can be translated similarly with an audio:: column, such as audio::es.

Switch between languages in the Survey123 field app

To switch between supported languages in your survey, open the menu in the upper right corner and choose from the list of available languages. If no translations have been supplied, no languages will be listed.

Default languages other than English

If you intend to use a survey with non-English labels on a device with a locale that is set to English, there is a subtle difference in behavior depending on how the non-English language is identified. The default column titled label can contain text in any language, and this content will be displayed for the labels of your questions by default. In most cases, this works as expected. In some cases, you may see right-to-left text displayed as left-to-right, or dates, currency, and calendars displayed in English.

To ensure the best translation experience, it is recommended that you do the following:

  • All text columns (labels, hints, and messages) should have the language's locale code in their titles, for example, label::he.
  • Define a default_language on the Settings tab.

When you use the locale code, Survey123 will not only ensure that the text you include in your spreadsheet is displayed as expected but also use the locale preferences to display the expected numbers, currency values, and calendar pickers.