Languages & Translations

With Unidy, you have complete control over the language and wording used throughout your instance. Tailor the login portal to match your brand's voice and tone, and ensure a localized experience for your global user base. For easier reading we are always referring to translations even if there is only a single language and you are looking to customize the wording.

In the following, we will guide you through the administration and setup process for single or multi-languages in Unidy. Please set up the language(s) on your staging environment first, before moving it to production.

Before setting up the feature, please make sure that the following topics are covered:

To access the language settings, admins can navigate to the Languages section within their admin portal (https://brand.unidy.de/admin/languages).

Relevant settings and description

To ensure that users always have easy access to their preferred language, Unidy provides a variety of manual and automated options for language selection.

Based on the selected languages, Unidy dynamically adapts all text elements, including phrases and email templates, to the selected language (e.g., switching from German to English). The selected language is saved in the respective user profile, once the user is logged into Unidy.

The data field preferred_language is also accessible for third-parties via API or Webhook.

The displayed language is determined by a priority ranking:

Users can easily switch between the available languages in the platform's footer. Once the language is selected it is the user-specific language preference.

When activated in the Brand Language Configuration, Unidy pre-selects the language for your user based on the respective device language used by the user. If the device language is not available the default language is selected.

Users can be directed to change their preferred language by visiting specific URLs, such as brand.unidy.de/language/de or .../language/en. To ensure these changes take effect, users must log in. To expedite this process, you can use the force_login=true query parameter in the URL, such as https://brand.unidy.de/language/de?force_login=true. Note that this functionality currently only works for email and password logins and not for social logins.

In the following, we explain how to manage translations and wordings in general.

When you enter the admin area for locale translations, you will see all translations that have been customized so far. On a fresh instance, this list is empty but Unidy provides a fully working set of texts for german, english, french and dutch.

In order to find a correct translation there are two approaches.

If you want to update the main title on the login/signup page “Log in or create account”

Then you can try to search for that text.

While presenting an easy approach, there are some limitations:

In order to make the translation keys visible in the front end, you need to switch to the “Show keys” mode that can be found in the top right corner. The mode can always be quit by a special menu that appears in the top right corner, when the mode is active.

In that mode you will see the keys of all used translations while navigating through the platform.

The search for those keys is then very specific, which will help you to identify mulitple results found in full text search.

As soon as you found the correct translation, you can edit it

If Brand is not set the translations will be valid for all brands.

The keys that end with _html are able to render any HTML markup that is placed into the translation.

If HTML markup is added to keys without that suffix, the HTML will just be rendered as text.

Some translations contain variables that are automatically set by the Unidy system and can be used in the translation.

In this example we lookup the translation “Connection with Services of Brand ID” via the “Show keys” mode and see that the content of that translation is “Connection with Services of” combined with a variable %{brand}

You can now updated that translation and choose to place the %{brand} on another position, or even not use it at all. %{brand} is the name of the respective Brand as state in Brands menu.

As all of text pieces in your Unidy ID, translations can be managed in the translation tool. However, there are some dynamic fields that must be set in the respective menu area.

Dynamic fields are all text pieces, that can be created by an admin:

These translations can be added by yourself through the admin. After creating a new object, you will see all text pieces as blue buttons. You can click these buttons to add translations.

By default you will be provided with all the language options that are activated for your Unidy ID. Missing translations are indicated by disabled flags on the text pieces. If you don’t add translations for a text, the base translation will be used instead. The base translation is the text that you added when creating the object initially. To save your translations click on Update [ dynamic field ] below the translation fields.