​
Universal Login localization

The experience is localized to the following languages. Entries marked with an asterisk are read right to left.
LanguageCode
Albaniansq
Amharicam
Arabic*ar
Arabic (Egypt)*ar-EG
Arabic (Saudi Arabia)*ar-SA
Armeniahy
Azerbaijaniaz
Basqueeu-ES
Bengalibn
Bosnianbs
Bulgarianbg
Catalanca-ES
Chinese - Hong Kongzh-HK
Chinese - Simplifiedzh-CN
Chinese - Traditionalzh-TW
Croatianhr
Czechcs
Danishda
Dutchnl
Englishen
English - Canadaen-CA
Estonianet
Farsi (Persian)*fa
Finnishfi
Frenchfr-FR
French - Canadafr-CA
Galiciangl-ES
Georgianka
Germande
Greekel
Gujratigu
Hebrew*he
Hindihi
Hungarianhu
Icelandicis
Indonesianid
Italianit
Japaneseja
Kannadakn
Koreanko
Latvianlv
Lithuanianlt
Macedonianmk
Malayms
Malayalamml
Marathimr
Mongolianmn
Montenegrinecnr
Myanmarmy
Norwegianno
Norwegian - Bokmålnb
Norwegian - Nynorsknn
Polishpl
Portuguese - Brazilpt-BR
Portuguese - Portugalpt-PT
Punjabipa
Romanianro
Russianru
Serbiansr
Slovaksk
Sloveniansl
Somaliso
Spanishes
Spanish - Argentinaes-AR
Spanish - Latin Americaes-419
Spanish - Mexicoes-MX
Swahilisw
Swedishsv
Tagalogtl
Tamazightzgh
Tamilta
Telugute
Thaith
Turkishtr
Ukrainianuk
Urdu*ur
Vietnamesevi
Welshcy

​
Language selection

The language to render the pages will be selected based on:
  • The languages supported by Auth0, which are listed above.
  • The list of languages configured in the Dashboard’s Tenant Settings section, where you can select the languages your tenant supports and select a default one. By default, the list has only English selected, but you can select the ones you need.
  • The value of the ui_locales parameter sent to the Authorization Request endpoint, which can be used to constrain the language list for an application or session. You can provide a space-delimited list of locales. The first locale on the list must match the enabled locale in your tenant to reflect in the UI.
  • The Accept-Language HTTP header sent by the browser. The pages will be rendered in this language if it is allowed by the settings above. If not, pages will be rendered in the default language.
To add a language that’s not listed above, use the to make a PATCH call to the Tenants endpoint with the following body, replacing he with the language code you want to add: 
{
  "enabled_locales": [
    "en","he"
  ]
}
After it’s added, specify the language in theui_locales query parameter of the login request. You can also specify the enabled languages for the tenant via the Management API using the Update Tenant Settings endpoint. The first language in the list will be the default one. 
curl --request PATCH \
  --url 'https://{yourDomain}/api/v2/tenants/settings' \
  --header 'authorization: Bearer API2_ACCESS_TOKEN' \
  --header 'content-type: application/json' \
  --data '{ "enabled_locales" : [ "en", "es"]}'

​
Right-to-left languages

Right-to-left text is currently in Early Access. To request this feature, contact Auth0 Support, and to learn more about Auth0’s product release cycle, read Product release stages.
Right-to-left (RtL) language support allows your tenant to display Arabic (standard, Egyptian, and Saudi Arabian), Persian, Hebrew, and Urdu text. Tenants that use RtL text must be WCAG 2.2 AA compliant, and if your tenant uses page templates, you must update the HTML tag to include the dir element. 
{% assign resolved_dir = dir | default: "auto" %}
<html lang="{{locale}}" dir="{{resolved_dir}}">
Go to Tenant Settings > Advanced and ensure the toggle shown below is disabled, then test any RtL languages in a dev environment with a custom page template before using them in production. To learn more, read Customize Universal Login Page Templates.
A photo of the right-to-left toggle in the Auth0 Tenant Settings.

​
Limitations

  • The ui_locales parameter can only be used in flows, as it’s not available in or WS-Federation.
  • The ui_locales parameter is not forwarded to upstream . To learn more about passing parameters to IdPs, read Pass Parameters to Identity Providers.
  • It is not possible to localize the scopes in the Consent page.

​
Known issues

  • The ULP renders the HTML lang attribute for the language code fr-FR as fr.
  • The ULP renders the HTML lang attribute for the language code pt-PT as pt.

​
Classic Login localization

In the Classic Login experience, localization is done using our JavaScript widgets for login, the password reset page and password policies. The MFA page by default uses the Auth0 Widget, which cannot be localized. You can create localized versions by using guardian.js. It is not possible to localize the Consent page.

​
Learn more