Configure Flexible Language Selection

Flexible language selection is an optional feature that allows users to select their preferred language on prompts associated with your application, such as the login screen. You can configure this feature individually for different Universal Login prompts. After implementing this feature for a specific prompt, a language selectio](/docs/images/added to the associated screen. Users can choose a preferred language from this menu to automatically render the prompt in that language.

Two Universal Login prompts showing the language selection menu.

Before you begin

Before you can implement flexible language selection, ensure the following requirements are met:

Use Universal Login.
- This feature is not available for custom login pages.
Configure a custom domain.
Enable the languages you plan to add to your prompts in your Auth0 tenant.
- On the Auth0 Dashboard, navigate to Settings > General > Languages and enable one or more desired languages.
  - For more information, review Universal Login Internationalization.

Implement flexible language selection

Setting up flexible language selection includes two primary steps:

Preparing your page template to facilitate language selection.
Configuring individual prompts to display language selection to users.

To get started, add the following script to your Universal Login page template to facilitate language selection.

<script>
  function updateSelectedLanguage() {
    const selectElement = document.getElementById('\''language'\'');
    const selectedValue = selectElement.value;
    const options = selectElement.options;
    for (let i = 0; i < options.length; i++) {
      if (options[i].value === selectedValue) {
        options[i].selected = true;
      } else {
        options[i].selected = false;
      }
    }
    document.getElementById('\''changeLanguage'\'').click();
  }
</script>

This script enables Universal Login prompts to render a dynamic language selection menu. Users can access this menu to apply their preferred language to a configured prompt. To add this script to your page template, use the Set Template for Universal Login endpoint.

Be aware that this call will overwrite any existing configurations you have made to your Universal Login page template. To avoid any disruptions, ensure you include all necessary page template customizations in this call.

Next, add language selection to one or more Universal Login prompts by configuring custom prompt partials. Partials refer to custom code inserted into an entry point within a prompt screen, such as the login screen. To learn more, review Customize Signup and Login Prompts. To add language selection to a specific prompt, use the Auth0 to configure custom prompt partials with the following parameters:

Parameter	Description	Example Value
`language`	Required. One or more languages to include in the language selection menu displayed to users.	`es`,`fr`,`en`
`persist`	Required. Determines whether the language should persist across the session.	`session`
`action`	Optional. Use this parameter in situations where you want users to be able to update their language without advancing the prompt. If the value is provided, the form is not automatically submitted when a user changes their language. Otherwise, the prompt automatically advances when a different language is selected.	`change-language`

Access the sections below to review code samples for different types of Universal Login prompts.

In the code samples below, ensure you replace the placeholders with the appropriate values:

Replace {yourDomain} with yourdomain.auth0.com.
Replace {mgmtApiToken} with your access token.

Personnalisation de la marque

Personnalisation du code

Personnalisation tierce

Configure Flexible Language Selection

Before you begin

Implement flexible language selection

​Before you begin

​Implement flexible language selection

​Prepare your Universal Login page template

​Configure individual Universal Login prompts

Before you begin

Implement flexible language selection

Prepare your Universal Login page template

Configure individual Universal Login prompts