> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ownid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Translations

> Learn how to customize your own translations for OwnID

## 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:

```javascript theme={null}
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.

<Note> 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](https://jsonlint.com/)) to ensure there are no syntax errors. </Note>

## Accessing Existing Labels

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

```curl theme={null}
https://i18n.prod.ownid.com/<locale>/web-sdk.json
```

The master file is considered the [English language](https://i18n.prod.ownid.com/en/web-sdk.json).

## Available Locales

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

| Locale | Link                                                    |
| ------ | ------------------------------------------------------- |
| ar     | [ar](https://i18n.prod.ownid.com/ar/web-sdk.json)       |
| bg     | [bg](https://i18n.prod.ownid.com/bg/web-sdk.json)       |
| cs     | [cs](https://i18n.prod.ownid.com/cs/web-sdk.json)       |
| da     | [da](https://i18n.prod.ownid.com/da/web-sdk.json)       |
| de     | [de](https://i18n.prod.ownid.com/de/web-sdk.json)       |
| de-CH  | [de-CH](https://i18n.prod.ownid.com/de-CH/web-sdk.json) |
| de-DE  | [de-DE](https://i18n.prod.ownid.com/de-DE/web-sdk.json) |
| de-AT  | [de-AT](https://i18n.prod.ownid.com/de-AT/web-sdk.json) |
| el     | [el](https://i18n.prod.ownid.com/el/web-sdk.json)       |
| en     | [en](https://i18n.prod.ownid.com/en/web-sdk.json)       |
| en-GB  | [en-GB](https://i18n.prod.ownid.com/en-GB/web-sdk.json) |
| en-AU  | [en-AU](https://i18n.prod.ownid.com/en-AU/web-sdk.json) |
| en-CA  | [en-CA](https://i18n.prod.ownid.com/en-CA/web-sdk.json) |
| en-NZ  | [en-NZ](https://i18n.prod.ownid.com/en-NZ/web-sdk.json) |
| en-US  | [en-US](https://i18n.prod.ownid.com/en-US/web-sdk.json) |
| es     | [es](https://i18n.prod.ownid.com/es/web-sdk.json)       |
| es-ES  | [es-ES](https://i18n.prod.ownid.com/es-ES/web-sdk.json) |
| es-MX  | [es-MX](https://i18n.prod.ownid.com/es-MX/web-sdk.json) |
| es-US  | [es-US](https://i18n.prod.ownid.com/es-US/web-sdk.json) |
| et-EE  | [et-EE](https://i18n.prod.ownid.com/et-EE/web-sdk.json) |
| he     | [he](https://i18n.prod.ownid.com/he/web-sdk.json)       |
| fi     | [fi](https://i18n.prod.ownid.com/fi/web-sdk.json)       |
| fr     | [fr](https://i18n.prod.ownid.com/fr/web-sdk.json)       |
| fr-CH  | [fr-CH](https://i18n.prod.ownid.com/fr-CH/web-sdk.json) |
| fr-FR  | [fr-FR](https://i18n.prod.ownid.com/fr-FR/web-sdk.json) |
| fr-CA  | [fr-CA](https://i18n.prod.ownid.com/fr-CA/web-sdk.json) |
| hr     | [hr](https://i18n.prod.ownid.com/hr/web-sdk.json)       |
| hu     | [hu](https://i18n.prod.ownid.com/hu/web-sdk.json)       |
| id     | [id](https://i18n.prod.ownid.com/id/web-sdk.json)       |
| it     | [it](https://i18n.prod.ownid.com/it/web-sdk.json)       |
| it-CH  | [it-CH](https://i18n.prod.ownid.com/it-CH/web-sdk.json) |
| it-IT  | [it-IT](https://i18n.prod.ownid.com/it-IT/web-sdk.json) |
| ja     | [ja](https://i18n.prod.ownid.com/ja/web-sdk.json)       |
| ko     | [ko](https://i18n.prod.ownid.com/ko/web-sdk.json)       |
| lt-LT  | [lt-LT](https://i18n.prod.ownid.com/lt-LT/web-sdk.json) |
| ms     | [ms](https://i18n.prod.ownid.com/ms/web-sdk.json)       |
| nl     | [nl](https://i18n.prod.ownid.com/nl/web-sdk.json)       |
| no     | [no](https://i18n.prod.ownid.com/no/web-sdk.json)       |
| pl     | [pl](https://i18n.prod.ownid.com/pl/web-sdk.json)       |
| pt     | [pt](https://i18n.prod.ownid.com/pt/web-sdk.json)       |
| pt-PT  | [pt-PT](https://i18n.prod.ownid.com/pt-PT/web-sdk.json) |
| ro     | [ro](https://i18n.prod.ownid.com/ro/web-sdk.json)       |
| ru     | [ru](https://i18n.prod.ownid.com/ru/web-sdk.json)       |
| sk     | [sk](https://i18n.prod.ownid.com/sk/web-sdk.json)       |
| sl     | [sl](https://i18n.prod.ownid.com/sl/web-sdk.json)       |
| sr     | [sr](https://i18n.prod.ownid.com/sr/web-sdk.json)       |
| sv     | [sv](https://i18n.prod.ownid.com/sv/web-sdk.json)       |
| th     | [th](https://i18n.prod.ownid.com/th/web-sdk.json)       |
| tr     | [tr](https://i18n.prod.ownid.com/tr/web-sdk.json)       |
| uk     | [uk](https://i18n.prod.ownid.com/uk/web-sdk.json)       |
| vi     | [vi](https://i18n.prod.ownid.com/vi/web-sdk.json)       |
| zh-CN  | [zh-CN](https://i18n.prod.ownid.com/zh-CN/web-sdk.json) |
| zh-TW  | [zh-TW](https://i18n.prod.ownid.com/zh-TW/web-sdk.json) |
| zh     | [zh](https://i18n.prod.ownid.com/zh/web-sdk.json)       |