Customization of the in-app text

Prev Next

The Mobile Authenticator Studio app offers the in-app text strings in different languages. By default, the following five languages are available:

  • English (mandatory, cannot be removed)

  • German

  • Italian

  • French

  • Spanish

You can add languages and/or remove any of the default languages except English as well as customize the default text strings.

The default text strings are for the most parts identical for iOS and Android, except for the permissions as these are platform-specific.

Customization CSV file

For the language and text customizations, OneSpan provides a CSV file where you make the changes as required. Once you return the updated CSV file to OneSpan, your customizations will be implemented in the app.

To modify the CSV file and save it correctly, we recommend one of the following editors as these work correctly and keep the encodings:

The following points must be taken into account when you update the CSV file:

  • The supported languages are deduced from the columns of the CSV file where each column corresponds to a language defined by its language/country code. The language/country codes must follow the ISO 3166 standard. For a list of codes, refer to ISO 3166 Country Codes.

    You can reuse the codes you are using in Mobile Authenticator Studio 4.x.

  • As English is mandatory, it must be the first column. English will always be used as default language for missing values in any language or for unsupported languages.

  • If the value for a certain key is empty, the value for English is used.

  • If an entire key (i.e., a row) is missing, the default English value is used for this missing key.

  • The length of the new text should be approximately the same as that of the original text to avoid breaking the Mobile Authenticator Studio user interface.

  • The CSV must use commas "," as separator.

Example scenarios

No CSV file provided

If you do not provide a CSV file, Mobile Authenticator Studio is available in English, French, German, Italian and Spanish with the default values translated by OneSpan.

CSV file provided with all keys defined

You provide the updated CSV file:

  • With three columns, "en", "fr, "pt"

  • All keys are defined inside the file.

Mobile Authenticator Studio is available in English, French, and Portuguese. All values are used from your file.

CSV file provided, only certain keys are defined

You provide a CSV file with two columns: "en", "ar" but only four keys (i.e., four rows) are defined inside.

Mobile Authenticator Studio displays the four values in Arabic and English as per the definition in the file. All other strings are the English default values as defined by OneSpan.