Supported Languages and Locales

Supported Languages

CLEAR currently supports the following languages:

  • English (en)
  • Spanish (es)
  • French (fr)
  • German (de)
  • Italian (it)

Supported Locales

CLEAR supports both language-only and region-specific locales:

  • en-US
  • en-MX
  • en-CA
  • es-MX
  • es-US
  • fr-CA
  • en
  • es
  • fr
  • de
  • it

Locale Selection Priority

CLEAR determines which language/locale to display using the following order of precedence:

  1. Previously Selected Locale

    If the user has already selected a locale in a prior CLEAR experience, that setting is reused.

  2. Browser Language Settings

    If no prior selection exists, CLEAR reads the user’s browser language preferences and selects the best match.

  3. API-Provided Locale

    If your integration includes a locale value in the create_verification_session API request, this will override browser settings.

  4. Default Fallback

    If none of the above are available, CLEAR defaults to:

en (English)

Forcing a Locale via URL

You can explicitly control the language of the CLEAR verification flow by passing a query parameter in the URL:

&cv_locale=<locale>

Example

To launch the flow in Spanish:

&cv_locale=es

You can also use region-specific values if needed:

&cv_locale=es-MX
&cv_locale=fr-CA

Best Practices

  • Prefer passing a locale explicitly if your app already knows the user’s language.
  • Use language-only codes (es, fr) unless regional differences matter.
  • Avoid conflicting signals (e.g., passing locale in API + different cv_locale in URL).
  • Always ensure a fallback experience (CLEAR will default to English automatically).

Did this page help you?