Language configuration

11. 02. 2025

The SDK.finance platform supports English and Ukrainian languages from the box, with English used by default.

The names of the properties for supported languages are defined in the following files:

web_bundle_en.properties – for English
web_bundle_uk.properties – for Ukrainian

Changing the Default Language

The default language can be changed in the system configuration using the i18n.default-locale variable:

i18n:

  locales: ['en', 'uk']

  default-locale: 'en'

Modifying Property Names for an Existing Language

1. Get all available languages.

Call the API GET /i18n/locales

By default, the response will contain the locales en and uk, along with the date of the last update:

{

    "records": [

        {

            "language": "en",

            "lastUpdatedDate": "2023-10-10T16:32:59.854Z"

        },

        {

            "language": "uk",

            "lastUpdatedDate": "2023-10-10T16:33:00.113Z"

        }

    ]

}

2. Download the i18n file for the language you want to modify

CalI the API GET /i18n/export/{fileName}

where {fileName} is the name of the required locale with the .property extension, e.g., en.property for English.

3. Modify the required names in the downloaded file

Edit the file using any text editor and update the required property names.

4. Upload the modified file

Call the API POST {{host}}/i18n/import

Attach the modified file in the request.

Adding a New Language

Let’s add French to the system as an example.

1. Create a new `.properties` file for the required language

For the source code option, create a file named: web_bundle_fr.properties. You can use web_bundle_en.properties as an example.
For the PAAS option, contact the SDK.finance team to create the file.

2. Add new language to the configuration

i18n: locales: ['en', 'uk', 'fr'] default-locale: 'en'

3. Fill in the new file with property names in the new language

For the source code option, you can update the file manually and redeploy the application, or use the API flow described above to update property names.
For the PAAS option, use the API flow described above to update property names.

Replacing an Existing Language

Let’s replace Ukrainian with French.

1. Download the i18n file for the language you want to replace