Translate questionnaire

Help applicants pass verification with questionnaires in their native tongue.

You can add translations to your questionnaires to verify applicants from different countries and regions in their native tongue.

You can translate the questionnaire text with AI, enter the translations manually, or send them via API. All three methods fill the same localization fields, and applicants see the translations in the same way.

Add questionnaire translation

Before you start translating, create the questionnaire in English, as described in this article, and fill in all the created fields (sections, questions, and so on).

📘

Note

To change the structure of your questionnaire, switch back to English.

Translate with AI

AI translation fills the localization fields of the questionnaire with a machine-translated draft, so you do not have to type the text in each language manually. You review and edit the draft before it reaches applicants.

To translate a questionnaire with AI:

  1. In the Dashboard, open the questionnaire created in English.
  2. Click + Add translation.
  3. Select the language to translate the questionnaire into.
  4. Click Translate. The localization fields are filled with the machine-translated draft.
  5. Review the draft and edit any field, if necessary.
  6. Click Publish and confirm publishing.

AI translation covers the following fields:

  • Questionnaire name and description.
  • Section titles and descriptions.
  • Question titles, descriptions, and placeholders.
  • Option titles.

The following elements are preserved during translation:

  • Placeholders used in section visibility conditions and text variables, for example, {sectionId.itemId}.
  • Markdown formatting and document links in titles, descriptions, and consent text.

The system only sends the text of the questionnaire template for translation, not the applicant answers.

Review and publish translations

AI-translated text is a draft visible only in the Dashboard. Applicants see the translation only after you publish the questionnaire.

If you publish a questionnaire that contains AI-generated text you have not reviewed, or fields that are not translated, a confirmation dialog is shown before the questionnaire is published.

❗️

Important

Sumsub does not guarantee the accuracy of AI translations. You are responsible for reviewing and approving translations before they are shown to applicants.

Translate manually

To add translations manually:

  1. Open the questionnaire created in English.
  2. Navigate to the Questionnaire language drop-down list and select the language.
  3. Enter the translation text in the chosen language in the fields. You can see the changes in the preview on the right.

Update translations after editing English text

Existing translations are not updated automatically when you change the English text of a questionnaire. The changed field shows the Not updated in <languages> caption until you translate it again or edit the translation manually.

Supported languages

In the following table, you can find the list of all supported languages for the Questionnaire. AI translation is available for all of these languages.

📘

Note

ISO 639-1 codes represent two-letter language codes that identify languages in software settings.

Code (ISO 639-1)Language
amAmharic
arArabic
hyArmenian
azAzerbaijani
bnBengali
bgBulgarian
myBurmese
caCatalan
kmCentral Khmer
zhChinese (Simplified)
zhTwChinese (Traditional)
hrCroatian
csCzech
daDanish
nlDutch
enEnglish
etEstonian
faFarsi
flFilipino
fiFinnish
frFrench
kaGeorgian
deGerman
elGreek
haHausa
heHebrew
hiHindi
huHungarian
idIndonesian
itItalian
jaJapanese
kkKazakh
koKorean
loLao
lvLatvian
ltLithuanian
msMalay
noNorwegian
plPolish
ptBrPortuguese (Brazil)
roRomanian
ruRussian
srSerbian
siSinhala
skSlovak
slSlovenian
esSpanish
swSwahili
svSwedish
tgTajik
thThai
trTurkish
ukUkrainian
urUrdu
uzUzbek
viVietnamese
zuZulu

Localized title

When creating a questionnaire, you can enable the Show name in SDK steps list setting as described here. If enabled, the SDK uses the questionnaire title for the step name.

If you add translations for that name, applicants see the localized version that matches their language.

❗️

Important

After updating a questionnaire name or its translations, the change may take up to 15 minutes to appear in the SDK.

Get questionnaire translation via Dashboard

To get the translation of a questionnaire via the Dashboard:

  1. IIn the Dashboard, go to Configurations → Applicant verification → Questionnaires and open a questionnaire of interest to see its structure. By default, the questionnaire is displayed in English.
  2. In the preview area on the right, from the Questionnaire language drop-down list, select the language in which you want to see the questionnaire.

You can see the translation both in the questionnaire structure and in the preview on the right.

📘

Note

Translation in the selected language is only available if it has been previously added.

Get questionnaire translation via API

You can use the Get questionnaire information method to get the translation of the questionnaire elements. Translations added with AI, manually in the Dashboard, or via API are stored in the same objects.

Localization of each title, description, and placeholder is stored in the specific localization objects:

  • localizedTitle — contains the title localization values.
  • localizedDesc — contains the description localization values.
  • localizedPlaceholder — contains the placeholder localization values.

Each of these objects shares the same structure with each localization stored in the values array as an object. Every object in the array contains the following attributes:

AttributeTypeDescription
langStringLanguage in the ISO 639-1 alpha-2 code (en by default).
valueStringCorresponding text in the specified language. Empty ("") if not provided.

When you select a language in the questionnaire, the text to display in the interface is taken from the corresponding object in the values array, if applicable. For example, if "lang": "de" exists, the value is used for German.

📘

Note

If a relevant lang value with the desired language is not available, the text is displayed in English (by default), even if you select a different language.

Translation examples in API

In the following API response example, you can see that each title, desc, and placeholder field is accompanied by the localizedTitle, localizedDesc, and localizedPlaceholder objects, respectively.

Entire response example

{
    "_id": "6717d0bc1696671999bc7a14",
    "id": "questionnaireWithDeT",
    "title": "Questionnaire with translation",
    "localizedTitle": {
        "values": [
            {
                "lang": "en",
                "value": "Questionnaire with translation"
            },
            {
                "lang": "de",
                "value": "Fragebogen mit Übersetzung"
            },
            {
                "lang": "pt",
                "value": "Questionário com tradução"
            }
        ]
    },
    "desc": "Example with multiple questionnaire languages",
    "localizedDesc": {
        "values": [
            {
                "lang": "en",
                "value": "Example with multiple questionnaire languages"
            },
            {
                "lang": "de",
                "value": "Beispiel mit mehreren Fragebogen-Sprachen"
            },
            {
                "lang": "pt",
                "value": "Exemplo com vários idiomas de questionário"
            }
        ]
    },
    "clientId": "aleksandr.khomutskii",
    "modifiable": null,
    "createdAt": "2024-10-22 16:20:12",
    "sections": [
        {
            "id": "section1",
            "title": "Section 1",
            "localizedTitle": {
                "values": [
                    {
                        "lang": "en",
                        "value": "Section 1"
                    },
                    {
                        "lang": "de",
                        "value": "Abschnitt 1"
                    },
                    {
                        "lang": "pt",
                        "value": "Seção 1"
                    }
                ]
            },
            "desc": "Section 1 description",
            "localizedDesc": {
                "values": [
                    {
                        "lang": "en",
                        "value": "Section 1 description"
                    },
                    {
                        "lang": "de",
                        "value": "Beschreibung von Abschnitt 1"
                    },
                    {
                        "lang": "pt",
                        "value": "Descrição da Seção 1"
                    }
                ]
            },
            "condition": null,
            "showCondition": null,
            "items": [
                {
                    "id": "question1",
                    "title": "Question 1",
                    "localizedTitle": {
                        "values": [
                            {
                                "lang": "en",
                                "value": "Question 1"
                            },
                            {
                                "lang": "de",
                                "value": "Frage 1"
                            },
                            {
                                "lang": "pt",
                                "value": "Pergunta 1"
                            }
                        ]
                    },
                    "desc": "Question 1 description",
                    "localizedDesc": {
                        "values": [
                            {
                                "lang": "en",
                                "value": "Question 1 description"
                            },
                            {
                                "lang": "de",
                                "value": "Beschreibung von Frage 1"
                            },
                            {
                                "lang": "pt",
                                "value": "Descrição da Pergunta 1"
                            }
                        ]
                    },
                    "type": "text",
                    "required": null,
                    "format": null,
                    "condition": null,
                    "showCondition": null,
                    "placeholder": "Placeholder text",
                    "localizedPlaceholder": {
                        "values": [
                            {
                                "lang": "en",
                                "value": "Placeholder text"
                            },
                            {
                                "lang": "de",
                                "value": "Platzhaltertext"
                            },
                            {
                                "lang": "pt",
                                "value": "Texto de espaço reservado"
                            }
                        ]
                    },
                    "options": null,
                    "arbitraryDocType": null
                },
                {
                    "id": "question2",
                    "title": "Question 2",
                    "localizedTitle": {
                        "values": [
                            {
                                "lang": "en",
                                "value": "Question 2"
                            },
                            {
                                "lang": "de",
                                "value": "Frage 2"
                            },
                            {
                                "lang": "pt",
                                "value": "Pergunta 2"
                            }
                        ]
                    },
                    "desc": "Question 2 description",
                    "localizedDesc": {
                        "values": [
                            {
                                "lang": "en",
                                "value": "Question 2 description"
                            },
                            {
                                "lang": "de",
                                "value": "Beschreibung von Frage 2"
                            },
                            {
                                "lang": "pt",
                                "value": "Descrição da Pergunta 2"
                            }
                        ]
                    },
                    "type": "multiSelect",
                    "required": null,
                    "format": null,
                    "condition": null,
                    "showCondition": null,
                    "placeholder": "",
                    "localizedPlaceholder": {
                        "values": [
                            {
                                "lang": "en",
                                "value": ""
                            }
                        ]
                    },
                    "options": [
                        {
                            "value": "opt1",
                            "title": "Option 1",
                            "localizedTitle": {
                                "values": [
                                    {
                                        "lang": "en",
                                        "value": "Option 1"
                                    },
                                    {
                                        "lang": "de",
                                        "value": "Wahl 1"
                                    },
                                    {
                                        "lang": "pt",
                                        "value": "Opção 1"
                                    }
                                ]
                            },
                            "score": 5.0
                        },
                        {
                            "value": "opt2",
                            "title": "Option 2",
                            "localizedTitle": {
                                "values": [
                                    {
                                        "lang": "en",
                                        "value": "Option 2"
                                    },
                                    {
                                        "lang": "de",
                                        "value": "Wahl 2"
                                    },
                                    {
                                        "lang": "pt",
                                        "value": "Opção 2"
                                    }
                                ]
                            },
                            "score": 10.0
                        }
                    ],
                    "arbitraryDocType": null
                }
            ],
            "delimiter": null
        }
    ]
}
📘

Note

By default, the title, desc, and placeholder values are in English, and match the "lang": "en" value of the corresponding object in the values array.

Examples of single objects

Below, you can see examples of the localizedTitle, localizedDesc, and localizedPlaceholder objects in the API response.

"title": "Questionnaire with translation",
"localizedTitle":{
   "values":[
      {
         "lang":"en",
         "value":"Questionnaire with translation"
      },
      {
         "lang":"de",
         "value":"Fragebogen mit Übersetzung"
      },
      {
         "lang":"pt",
         "value":"Questionário com tradução"
      }
   ]
}
"desc":"Section 1 description",
"localizedDesc":{
   "values":[
      {
         "lang":"en",
         "value":"Section 1 description"
      },
      {
         "lang":"de",
         "value":"Beschreibung von Abschnitt 1"
      },
      {
         "lang":"pt",
         "value":"Descrição da Seção 1"
      }
   ]
}
"placeholder":"Placeholder text",
"localizedPlaceholder":{
   "values":[
      {
         "lang":"en",
         "value":"Placeholder text"
      },
      {
         "lang":"de",
         "value":"Platzhaltertext"
      },
      {
         "lang":"pt",
         "value":"Texto de espaço reservado"
      }
   ]
}

Example of questions

In a questionnaire, localization objects can also be applied to questions containing the options array.

If this is the case, the only field that can be accompanied by localization is title. The localizedTitle provides a translation for each of the selected items. See the example below.

"options":[
   {
      "value":"opt1",
      "title":"Option 1",
      "localizedTitle":{
         "values":[
            {
               "lang":"en",
               "value":"Option 1"
            },
            {
               "lang":"de",
               "value":"Wahl 1"
            },
            {
               "lang":"pt",
               "value":"Opção 1"
            }
         ]
      },
      "score":5.0
   },
   {
      "value":"opt2",
      "title":"Option 2",
      "localizedTitle":{
         "values":[
            {
               "lang":"en",
               "value":"Option 2"
            },
            {
               "lang":"de",
               "value":"Wahl 2"
            },
            {
               "lang":"pt",
               "value":"Opção 2"
            }
         ]
      },
      "score":10.0
   }
]

Did this page help you?