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-USen-MXen-CAes-MXes-USfr-CAenesfrdeit
Locale Selection Priority
CLEAR determines which language/locale to display using the following order of precedence:
-
Previously Selected Locale
If the user has already selected a locale in a prior CLEAR experience, that setting is reused.
-
Browser Language Settings
If no prior selection exists, CLEAR reads the user’s browser language preferences and selects the best match.
-
API-Provided Locale
If your integration includes a locale value in the create_verification_session API request, this will override browser settings.
-
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
localein API + differentcv_localein URL). - Always ensure a fallback experience (CLEAR will default to English automatically).
Updated 4 months ago