DobroDesk Help Center
Use English or Ukrainian in the DobroDesk website widget
Use automatic language detection or select an explicit widget locale, then verify interface labels, public answers and customer messages together.
What you'll achieve
The widget opens in English or Ukrainian and falls back to English when a visitor's browser requests another language.
Understand what is localized
The widget loads two kinds of language content. Interface text includes the launcher, buttons, field labels, validation and status messages. Customer content includes suggested answers and guided support paths approved for that locale.
Changing only the interface language does not translate an existing public answer. Each customer-facing answer must be reviewed and published for its own locale so customers do not receive a mixed-language experience.
- English uses the locale code en.
- Ukrainian uses the locale code uk.
- A regional browser value such as uk-UA is matched to its primary language code uk.
- Any other locale currently falls back to English.
Use automatic language detection
The generated embed code uses auto by default. On each page load the widget reads the browser's primary language. It uses Ukrainian for uk or uk-UA, English for en or en-US and English as the fallback for other languages. Automatic detection does not scan page text or translate content in the browser.
<script
async
src="https://dobrodesk.com/widget/loader/v1.min.js"
data-dobrodesk-integration="wgt_7f4c1d2e3a5b6980718293a4b5c6d7e8"
data-dobrodesk-locale="auto"
></script>Use auto when the website serves visitors in several languages and the browser setting is a reasonable signal for the customer's preference.
Set an explicit language for a localized page
Use an explicit locale when the website already has separate language routes and the widget should follow the selected site language. Use uk on the Ukrainian route and en on the English route. These are the two public widget locales currently available.
<script
async
src="https://dobrodesk.com/widget/loader/v1.min.js"
data-dobrodesk-integration="wgt_7f4c1d2e3a5b6980718293a4b5c6d7e8"
data-dobrodesk-locale="uk"
></script>Keep one embed on the page. Render the appropriate locale value from the website's existing language state instead of adding one script per language.
Set or change the locale with the SDK
Pass en or uk during initialization when the application already knows its current language. If the visitor changes language without a full page reload, call setLocale with the new supported locale code. The widget reloads the matching interface and customer content for the existing integration.
const supportWidget = createDobroDeskWidget({
integrationId: "wgt_7f4c1d2e3a5b6980718293a4b5c6d7e8",
locale: currentSiteLocale,
});
await supportWidget.ready;
// After an in-app language change
supportWidget.setLocale("uk");Prepare public content for each language
Decide whether each website route should use auto, en or uk. The fallback for every other browser language is currently English.
Create or review the suggested answers and guided paths separately in English and Ukrainian. Translate meaning and current policy, not only individual words.
Check product names, prices, legal wording, business hours and expected reply times in both versions.
Publish only complete customer-facing answers. If one language is not ready, keep automatic AI replies off for that language and route the conversation to a teammate.
Machine translation can help prepare a draft, but a person responsible for customer communication should review it before publication.
Test English, Ukrainian and fallback behavior
Open the public website in a private window with the browser language set to the locale being tested.
Check the Support button, header, availability, form fields, validation and confirmation message.
Open every suggested answer and guided path. Look for missing text keys or a sentence that falls back to another language.
Send a message containing the locale name and confirm the conversation reaches DobroDesk with that locale.
Repeat the fallback test with another browser language and confirm English appears.