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).
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:
- In the Dashboard, open the questionnaire created in English.
- Click + Add translation.
- Select the language to translate the questionnaire into.
- Click Translate. The localization fields are filled with the machine-translated draft.
- Review the draft and edit any field, if necessary.
- 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.
ImportantSumsub 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:
- Open the questionnaire created in English.
- Navigate to the Questionnaire language drop-down list and select the language.
- 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.
NoteISO 639-1 codes represent two-letter language codes that identify languages in software settings.
| Code (ISO 639-1) | Language |
|---|---|
| am | Amharic |
| ar | Arabic |
| hy | Armenian |
| az | Azerbaijani |
| bn | Bengali |
| bg | Bulgarian |
| my | Burmese |
| ca | Catalan |
| km | Central Khmer |
| zh | Chinese (Simplified) |
| zhTw | Chinese (Traditional) |
| hr | Croatian |
| cs | Czech |
| da | Danish |
| nl | Dutch |
| en | English |
| et | Estonian |
| fa | Farsi |
| fl | Filipino |
| fi | Finnish |
| fr | French |
| ka | Georgian |
| de | German |
| el | Greek |
| ha | Hausa |
| he | Hebrew |
| hi | Hindi |
| hu | Hungarian |
| id | Indonesian |
| it | Italian |
| ja | Japanese |
| kk | Kazakh |
| ko | Korean |
| lo | Lao |
| lv | Latvian |
| lt | Lithuanian |
| ms | Malay |
| no | Norwegian |
| pl | Polish |
| ptBr | Portuguese (Brazil) |
| ro | Romanian |
| ru | Russian |
| sr | Serbian |
| si | Sinhala |
| sk | Slovak |
| sl | Slovenian |
| es | Spanish |
| sw | Swahili |
| sv | Swedish |
| tg | Tajik |
| th | Thai |
| tr | Turkish |
| uk | Ukrainian |
| ur | Urdu |
| uz | Uzbek |
| vi | Vietnamese |
| zu | Zulu |
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.
ImportantAfter 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:
- 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.
- 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.
NoteTranslation 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:
| Attribute | Type | Description |
|---|---|---|
lang | String | Language in the ISO 639-1 alpha-2 code (en by default). |
value | String | Corresponding 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.
NoteIf a relevant
langvalue 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
}
]
}
NoteBy default, the
title,desc, andplaceholdervalues are in English, and match the"lang": "en"value of the corresponding object in thevaluesarray.
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
}
]Updated 9 days ago