With SDK text, you can change the default wording your applicants see during verification — instructions, button labels, error messages, email templates, and more. Edit a text, see the result in a live preview, and publish when you're ready.

Use it to:

• Tailor verification instructions to your business needs.
• Add extra explanations where applicants tend to get stuck.
• Match your company's tone of voice.

The editor has three areas that work together:

• Navigation — the list of verification steps, in the order your applicants see them. Open a step to view its screens.
• Preview — a live rendering of the selected screen, exactly as your applicants see it.
• Editor — the texts for the selected screen, each with a plain-language label.

At the top of the navigation you switch between channels using tabs:

• Web — all texts displayed in your WebSDK that also contain prompts, labels, and instructions based on the applicant's step and actions.

• Mobile — all texts displayed in your MobileSDK, such as instructions, statuses that depend on the applicant's current step, and actions.

• Email & SMS — templates for email notifications and SMS, such as status updates, informational messages, or applicant action guidance.

General labels, error messages, country names, and rejection comments are synced between Web and Mobile — editing one updates the other.

The editor marks synced content with a Synced badge on a section or an icon on a field — hover it to see what a change affects.

Find text you want to change

You do not need to know key names. There are two ways to get to a text:

1. Browse by step. Steps in the navigation follow the order of the verification flow — Welcome, Identity Document, Selfie & Liveness, and so on. Open a step to see its screens, then pick the screen that contains the text. The preview updates so you can confirm you are in the right place.
2. Search. Use the search field above the navigation to jump straight to a text. Search matches both the label and the text your applicants see, so you can look up a text by what it says on screen.

Customize default text

To change the default text:

1. In the Dashboard, go to the SDK text page.
2. Select the screen in the navigation, or find the text through search.
3. In the editor on the right, each text has a plain-language label that says where it appears — a button, a heading, an error message. Find the text you want and change its value.
4. Watch the preview update as you type — this is how the screen will look to your applicants.
5. Click Publish to update the text set and translations.
6. To apply changes in other languages, pick the Language selector in the top right corner and choose the supported language that you want to change. By default, the English language is selected.
   
   Always publish before switching to another language. If you switch languages with unpublished changes, you will be asked to publish or discard them first.

You can always restore Sumsub's default text. To do so:

1. Click the reset icon next to any text you have changed to restore that field.
2. For a list of texts, such as success tips, the icon sits on the whole list and restores every line at once, not just one.
3. To undo everything for the language you are editing, use Reset to default in the editor header menu.

Manage languages

The language you are editing is shown in the editor header. Click it to open the language list and switch to another language. The list shows only the languages available for the current channel.

The menu next to it holds everything else you can do with a language:

• Export — download the texts as JSON. You can export more than one channel at once; each channel is saved as a separate file.
• Import — upload a JSON file to replace the texts for one channel and language.
• Reset to default — undo all your changes for the current language and go back to Sumsub's default texts.

Sumsub provides default texts in every supported language, so you only edit what you want to change. Only two things are not covered:

• Questionnaires, translated on their own page.
• Custom fields you added yourself.

Attach text set to verification levels

To make a text set apply to a verification level:

1. In the Dashboard, go to the Verification levels page and open the level.
2. On the Steps tab, scroll to SDK text and select your text set from the drop-down.
3. Save your changes.