Docs

Universal Login Internationalization

Internationalization in the New Universal Login Experience

The New Universal Login Experience is currently localized to the languages below, with more languages to be added over time:

Code Language
da Danish
de German
en English
es Spanish
fi Finnish
fr French
it Italian
ja Japanese
nb Norwegian
nl Dutch
pt-BR Portuguese (Brazilian)
pt-PT Portuguese (Portugal)
ru Russian
sv Swedish
zh-CN Chinese (Simplified)
zh-TW Chinese (Traditional)

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 Tenant Settings, where you can select the languages your tenant supports and select a default one. By default, the list has only English, so if you want to support other languages you first need to update the list.
  • 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.
  • 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.

Setting the tenant supported languages

You can set the supported and default languages in the Dashboard's Tenant Settings section.

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.




Current Limitations

  • It is not possible for you to add additional languages (although Auth0 will be adding more over time).
  • It is not possible for you to override the copy for a specific piece of text.
  • The ui_locales parameter can only be used in OAuth flows, as it’s not available in SAML or WS-Federation.
  • The ui_locales parameter is not forwarded to upstream IdPs.
  • It is not possible to localize the scopes in the Consent page.

Internationalization in the Classic Universal Login Experience

In the Classic Universal Login experience, localization is done using our JavaScript widgets for login, the password reset page and password policies.

The Guardian MFA page by default uses the MFA Widget, which cannot be localized. You can create localized versions by using guardian.js.

It is not possible to localize the Consent page.