Customising Portal Texts and Adding Additional Languages

This guide explains how to tailor the Portal’s interface by customising its text and adding support for additional languages. By changing which texts are shown to users, you can ensure the Portal matches your organisation’s language requirements and provides a localised experience for users worldwide.

Background Information

The portal language configuration can be managed directly from the dashboard. Under Configure Your VASP, navigate to Address Ownership → Portal Customisation in the settings.

Obtaining the Default lang.json

Download the current lang.json using the download button next to the Language field. This file contains all translatable strings used throughout the portal interface.

Customising Existing Text

Open lang.json and modify the existing text strings at will. Uploads replace the entire language configuration. Retain all languages you want to offer and the complete set of string keys for each language. Missing keys do not fall back to English and can prevent the portal from rendering correctly.

Adding Support for Additional Languages

Open lang.json and add new top-level object keys for the desired languages and translations for all the existing text strings. The new top-level keys need to follow the BCP 47 language tag format, e.g. "de-CH" for Swiss-German. Only then the Portal will automatically switch to the user's preferred language.

This task can be automated using one of the popular AI tools but the translations likely still need manual adjustments.

Uploading the Modified lang.json

Once the file is ready, upload it using the Language field in Address Ownership → Portal Customisation and save the settings.