Menu

Expand
Rate this page:

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.

Loading Code Sample...
        
        

        Send an SMS OTP in Spanish

        SMS messages sent with Programmable Messaging or Verify are priced per message segment.

        Messages sent in certain language locales, including pt, pt_BR, cs, and el or in non-GSM characters may be split into multiple message segments. You can check how many message segments your message will use with the Messaging Segment Calculator tool.

        Learn more about how to limit message segments in our developer best practices.

        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.

        Language Language Tag Supported Channels
        Afrikaans af SMS, WhatsApp
        Arabic ar SMS, WhatsApp
        Catalan ca SMS, WhatsApp, Voice
        Chinese (Simplified using mainland terms) zh or zh-CN SMS, WhatsApp, Voice
        Chinese (Simplified using Hong Kong terms) zh-HK SMS, WhatsApp, Voice
        Croatian hr SMS, WhatsApp
        Czech cs SMS, WhatsApp
        Danish da SMS, WhatsApp, Voice
        Dutch nl SMS, WhatsApp, Voice
        English (American) en SMS, WhatsApp, Voice
        English (British) en-GB Voice
        Estonian et SMS, WhatsApp
        Finnish fi SMS, WhatsApp, Voice
        French fr SMS, WhatsApp, Voice
        German de SMS, WhatsApp, Voice
        Greek el SMS, WhatsApp
        Hebrew he SMS, WhatsApp
        Hindi hi SMS, WhatsApp
        Hungarian hu SMS, WhatsApp
        Indonesian id SMS, WhatsApp
        Italian it SMS, WhatsApp, Voice
        Japanese ja SMS, WhatsApp, Voice
        Kannada kn SMS, WhatsApp
        Korean ko SMS, WhatsApp, Voice
        Lithuanian lt SMS, WhatsApp
        Malay ms SMS, WhatsApp
        Marathi mr SMS, WhatsApp
        Norwegian nb SMS, WhatsApp, Voice
        Polish pl SMS, WhatsApp, Voice
        Portuguese (Brazilian) pt-BR SMS, WhatsApp, Voice
        Portuguese pt SMS, WhatsApp, Voice
        Romanian ro SMS, WhatsApp
        Russian ru SMS, WhatsApp, Voice
        Slovak sk SMS, WhatsApp
        Spanish es SMS, WhatsApp, Voice
        Swedish sv SMS, WhatsApp, Voice
        Tagalog tl SMS, WhatsApp
        Telugu te SMS, WhatsApp
        Thai th SMS, WhatsApp
        Turkish tr SMS, WhatsApp
        Ukrainian uk SMS, WhatsApp
        Vietnamese vi SMS, WhatsApp

        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

        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:

        Language Language Tag
        Abkhaz ab
        Afar aa
        Akan ak
        Albanian sq
        Amharic am
        Aragonese an
        Armenian hy
        Assamese as
        Avaric av
        Avestan ae
        Aymara ay
        Azerbaijani az
        Bambara bm
        Bashkir ba
        Basque eu
        Belarusian be
        Bengali bn
        Bihari bh
        Bislama bi
        Bosnian bs
        Breton br
        Bulgarian bg
        Burmese my
        Chamorro ch
        Chechen ce
        Chichewa, Chewa, Nyanja ny
        Chuvash cv
        Cornish kw
        Corsican co
        Cree cr
        Divehi, Dhivehi, Maldivian dv
        Esperanto eo
        Ewe ee
        Faroese fo
        Fijian fj
        Fula, Fulah, Pulaar, Pular ff
        Galician gl
        Georgian ka
        Guaraní gn
        Gujarati gu
        Haitian, Haitian Creole ht
        Hausa ha
        Herero hz
        Hiri Motu ho
        Interlingua ia
        Interlingue ie
        Irish ga
        Igbo ig
        Inupiaq ik
        Ido io
        Icelandic is
        Inuktitut iu
        Javanese jv
        Kalaallisut, Greenlandic kl
        Kanuri kr
        Kashmiri ks
        Kazakh kk
        Khmer km
        Kikuyu, Gikuyu ki
        Kinyarwanda rw
        Kirghiz, Kyrgyz ky
        Komi kv
        Kongo kg
        Kurdish ku
        Kwanyama, Kuanyama kj
        Latin la
        Luxembourgish, Letzeburgesch lb
        Luganda lg
        Limburgish, Limburgan, Limburger li
        Lingala ln
        Lao lo
        Lithuanian lt
        Luba-Katanga lu
        Latvian lv
        Manx gv
        Macedonian mk
        Malagasy mg
        Malayalam ml
        Maltese mt
        Māori mi
        Marshallese mh
        Mongolian mn
        Nauru na
        Navajo, Navaho nv
        North Ndebele nd
        Nepali ne
        Ndonga ng
        Norwegian Nynorsk nn
        Norwegian no
        Nuosu ii
        South Ndebele nr
        Occitan oc
        Ojibwe, Ojibwa oj
        Old Church Slavonic, Church Slavic, Church Slavonic, Old Bulgarian, Old Slavonic cu
        Oromo om
        Oriya or
        Ossetian, Ossetic os
        Panjabi, Punjabi pa
        Pāli pi
        Persian fa
        Pashto, Pushto ps
        Quechua qu
        Romansh rm
        Kirundi rn
        Sanskrit (Saṁskṛta) sa
        Sardinian sc
        Sindhi sd
        Northern Sami se
        Samoan sm
        Sango sg
        Serbian sr
        Scottish Gaelic, Gaelic gd
        Shona sn
        Sinhala, Sinhalese si
        Slovene sl
        Somali so
        Southern Sotho st
        Sundanese su
        Swahili sw
        Swati ss
        Tamil ta
        Tajik tg
        Tigrinya ti
        Tibetan Standard, Tibetan, Central bo
        Turkmen tk
        Tswana tn
        Tonga (Tonga Islands) to
        Tsonga ts
        Tatar tt
        Twi tw
        Tahitian ty
        Uighur, Uyghur ug
        Ukrainian uk
        Urdu ur
        Uzbek uz
        Venda ve
        Volapük vo
        Walloon wa
        Welsh cy
        Wolof wo
        Western Frisian fy
        Xhosa xh
        Yiddish yi
        Yoruba yo
        Zhuang, Chuang za

        Rate this page:

        Need some help?

        We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

        Loading Code Sample...
              
              
              

              Thank you for your feedback!

              Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

              Sending your feedback...
              🎉 Thank you for your feedback!
              Something went wrong. Please try again.

              Thanks for your feedback!

              thanks-feedback-gif