Change UI texts and translations
17.3.2.4.2. Change Loginapp REST UI texts and translations with the UI SDK

Basic Customizations

The Loginapp REST UI supports translation and internationalization (i18n).

  • It ships with translations for:
  • English
  • German
  • French
  • Italian

Changing REST UI texts

The UI SDK allows for easy changes to the default translations and/or adding new texts.

Language-specific texts, aka translations, are stored in:
$CUSTOM_DIRECTORY/src/assets/custom/i18n

For example, to change the English text of the Username label on the password page, simply add:

authentication.password.username = Your username

To identify the keys used for a particular use-case, you may enable the option Show Translation Keys in the Loginapp REST UI SDK settings. As a result, the relevant keys are displayed directly in the SDKs development UI. Alternatively, download the templates below which include all built-in translation keys and their default values.

Built-in Translations in Airlock IAM

The following i18n property files contain all the default translations for all languages that are provided with Airlock IAM:

These files are provided for reference only. It is recommended to only add (uncomment) keys that need to be customized.

Adding a new language

To add a new language, do the following:

  • 1.
    In $CUSTOM_DIRECTORY/src/sdk/config/custom.sdk.config.js uncomment config.languages and add the new language in the list of available languages.
  • 2.
    Create a corresponding language file in $CUSTOM_DIRECTORY/src/assets/custom/i18n (e.g. es.properties).
  • 3.
    Add translations for all used text elements. The built-in properties for the languages shipped with the product are linked above.
  • The new language is now available in the SDK and can be used in dev mode and will be included in the SDK build artifact.

The IAM configuration must be adapted, too: It also defines the set of available languages.

  • In the Config Editor, go to Loginapp >> Language Settings
  • Add the language to the Valid Languages list.

Depending on the used feature set, there may be other points in the configuration where the new language must be added (e.g. language choice in user registration self-service or user management in the Adminapp).