Overview

OwnID allows clients to customize the translations used in their front-end implementations. This can be done by passing a JSON object with specific keywords and their corresponding values for each locale. This flexibility makes it easier to fine-tune user interfaces according to different language needs.

Setting Up Custom Translations

To override specific labels for a given locale, use the setTranslations method after initializing OwnID. Here’s a basic example:

ownid('setTranslations', 
    {
        "en": {
            "account-recover": {
                "title": "Speed up your sign-in",
                "description": "Would you like sign-in without a password?",
                "cta": "Use Face ID",
                "skip": "I prefer to set a password",
                "md": {
                    "cta": "Continue"
                }
            }
        },
        "fr": {
            //replace this with the translations for french language
        }
    }
);

Please note:

  • You can override translations for as many or as few labels as necessary.
  • This code should be executed after initializing OwnID.
As a best practice, only override the labels that are strictly necessary. Additionally, we recommend validating your JSON format using an online tool (such as JSONLint) to ensure there are no syntax errors.

Accessing Existing Labels

Clients can access the existing labels for different locales using the following URL pattern:

https://i18n.prod.ownid.com/<locale>/web-sdk.json

The master file is considered the English language.

Available Locales

Below is a table with the available locales. Click on the link to access the existing labels for each language:

LocaleLink
arar
bgbg
cscs
dada
dede
de-CHde-CH
de-DEde-DE
de-ATde-AT
elel
enen
en-GBen-GB
en-AUen-AU
en-CAen-CA
en-NZen-NZ
en-USen-US
eses
es-ESes-ES
es-MXes-MX
es-USes-US
et-EEet-EE
hehe
fifi
frfr
fr-CHfr-CH
fr-FRfr-FR
fr-CAfr-CA
hrhr
huhu
idid
itit
it-CHit-CH
it-ITit-IT
jaja
koko
lt-LTlt-LT
msms
nlnl
nono
plpl
ptpt
pt-PTpt-PT
roro
ruru
sksk
slsl
srsr
svsv
thth
trtr
ukuk
vivi
zh-CNzh-CN
zh-TWzh-TW
zhzh

Was this page helpful?