Verify Supported Languages

Language translations are defined by a locale value, also known as a “language tag”. For example, the locale value for English (American) is en.

For any type of Verify template used, the locale will automatically resolve based on the country code of the phone number provided for Verifications sent using the SMS, Voice, or WhatsApp channels, with en or a custom template’s default language as the fallback locale if a translation is not available. See a list of phone number country code to language mappings here. Using this automatic resolution is highly recommended. If a language override is desired, you can specify the locale parameter when creating a Verification.

The locale values follow country-region format as described in IETF's BPC 47 for the languages listed below. If an unsupported override locale is given, a 404 error will be returned. In that case, we recommend that you retry the request without the locale parameter to implement a fallback to the country code's default language or English.

Language support varies depending on if a Verify Default, pre-approved or custom template is used and what channel it’s sent with. Learn more about the differences between these templates types here.

Verify Default Template

This table shows the current language support for the Verify Default template. This template is used automatically if a pre-approved or custom template is not specified in your Verification request and your Verify Service does not have a pre-approved or custom default template set.

Pre-approved Templates

Currently, only some languages that are supported by Verify are supported by pre-approved templates, with plans to continue adding translations and expanding language support.

Checking the available languages per-template via API

• View available templates using the Get a List of Available Templates endpoint.
• Check the translations property of the template to see supported languages.

Checking the available languages per-template via Twilio Console

• Navigate to Twilio Console > Verify > Services page and select your Verify Service.
• On the Settings page under the General tab, select a Message body under the Template configuration heading.
• Check the Message preview section for Locale Preview dropdown for a list of supported languages.

Custom Templates

The template requester must provide translations when making a custom template creation request, read this support article for more information on how to make that request. Each translation needs to be mapped to a locale value. The locale value can be defined by the template requester, but must be of the format XX (e.g. pt) or XX-XX (e.g. pt-br) and consist of the following locale “component” values, as defined by IETF's BPC 47.

Custom templates support all language and channel combinations currently supported by the Verify Default template, in addition to the following langauges in all channels except for Voice: