Locales
Locales and locale strings
Overview
This page outlines the standard General Translation uses to represent locales and languages, as well as the list of currently supported locales.
Locale strings
General Translation uses a variant of the BCP 47 language tag standard to represent locales and languages. BCP 47 language tags are the Internet Best Current Practice (BCP) for identifying languages in both spoken and written forms. These tags provide a consistent way to specify languages, allowing applications to adapt content, format, and behaviour based on the userโs locale.
Language tags comprise one or more subtags separated by the "-" character. The subtags include the following components:
- Language subtag: Represents the primary language, e.g.,
enfor English,esfor Spanish. - Region subtag: Specifies a country or region, e.g.,
USfor the United States,FRfor France. - Script subtag (optional): Indicates the writing script, e.g.,
Latnfor Latin script. - Variant subtag (optional): Identifies a specific variation of a language, e.g.,
arevelafor Eastern Armenian.
When you combine these tags, we refer to this as a locale or locale tag.
Commonly Used Tags
In practice, most language tags consist of two subtags: a language and a region. Here are some common examples:
| Language Tag | Description |
|---|---|
en-US | English as used in the US |
es-ES | Spanish as used in Spain |
fr-CA | French as used in Canada |
zh-CN | Simplified Chinese (China) |
de-DE | German as used in Germany |
Extended Tags
Language tags can include additional subtags for greater specificity:
- Example:
hy-Latn-IT-arevelahy: Armenian (language)Latn: Latin (script)IT: Italy (region)arevela: Eastern Armenian (variant)
This tag denotes Eastern Armenian written in the Latin script, as used in Italy.
Exceptions to BCP 47 in GT
๐ง This section is currently under construction. ๐ง
Supported locales
This section lists all locales that are currently supported by General Translation.
A note on lowโresource languages
Our system leverages some of the most advanced LLMs on the market to provide accurate translations; however, these models are not without their limitations. Certain languages may not be supported by the model provider youโve selected, or by any of the available providers. These are known as โlowโresource languagesโ.
Lowโresource languages vary between models, so if you specify a preferred model provider in your configuration, you may want to check that providerโs list of supported languages.
Official list
- af๐ฟ๐ฆAfrikaans
- am๐ช๐นAmharic
- ar๐ช๐ฌArabic
- ar-AE๐ฆ๐ชArabic (United Arab Emirates)
- ar-EG๐ช๐ฌArabic (Egypt)
- ar-LB๐ฑ๐งArabic (Lebanon)
- ar-MA๐ฒ๐ฆArabic (Morocco)
- ar-SA๐ธ๐ฆArabic (Saudi Arabia)
- bg๐ง๐ฌBulgarian
- bn๐ง๐ฉBangla
- bs๐ง๐ฆBosnian
- ca๐Catalan
- cs๐จ๐ฟCzech
- cy๐ด๓ ง๓ ข๓ ท๓ ฌ๓ ณ๓ ฟWelsh
- da๐ฉ๐ฐDanish
- de๐ฉ๐ชGerman
- de-AT๐ฆ๐นAustrian German
- de-CH๐จ๐ญSwiss High German
- de-DE๐ฉ๐ชGerman (Germany)
- el๐ฌ๐ทGreek
- el-CY๐จ๐พGreek (Cyprus)
- el-EL๐Greek (EL)
- en๐บ๐ธEnglish
- en-AU๐ฆ๐บAustralian English
- en-CA๐จ๐ฆCanadian English
- en-GB๐ฌ๐งBritish English
- en-NZ๐ณ๐ฟEnglish (New Zealand)
- en-US๐บ๐ธAmerican English
- es๐ช๐ธSpanish
- es-419๐Latin American Spanish
- es-AR๐ฆ๐ทSpanish (Argentina)
- es-CL๐จ๐ฑSpanish (Chile)
- es-CO๐จ๐ดSpanish (Colombia)
- es-ES๐ช๐ธEuropean Spanish
- es-MX๐ฒ๐ฝMexican Spanish
- es-PE๐ต๐ชSpanish (Peru)
- es-US๐บ๐ธSpanish (United States)
- es-VE๐ป๐ชSpanish (Venezuela)
- et๐ช๐ชEstonian
- fa๐ฎ๐ทPersian
- fi๐ซ๐ฎFinnish
- fil๐ต๐ญFilipino
- fr๐ซ๐ทFrench
- fr-BE๐ง๐ชFrench (Belgium)
- fr-CA๐จ๐ฆCanadian French
- fr-CH๐จ๐ญSwiss French
- fr-CM๐จ๐ฒFrench (Cameroon)
- fr-FR๐ซ๐ทFrench (France)
- fr-SN๐ธ๐ณFrench (Senegal)
- gu๐ฎ๐ณGujarati
- he๐ฎ๐ฑHebrew
- hi๐ฎ๐ณHindi
- hr๐ญ๐ทCroatian
- hu๐ญ๐บHungarian
- hy๐ฆ๐ฒArmenian
- id๐ฎ๐ฉIndonesian
- is๐ฎ๐ธIcelandic
- it๐ฎ๐นItalian
- it-CH๐จ๐ญItalian (Switzerland)
- it-IT๐ฎ๐นItalian (Italy)
- ja๐ฏ๐ตJapanese
- ka๐ฌ๐ชGeorgian
- kk๐ฐ๐ฟKazakh
- kn๐ฎ๐ณKannada
- ko๐ฐ๐ทKorean
- la๐ป๐ฆLatin
- lt๐ฑ๐นLithuanian
- lv๐ฑ๐ปLatvian
- mk๐ฒ๐ฐMacedonian
- ml๐ฎ๐ณMalayalam
- mn๐ฒ๐ณMongolian
- mr๐ฎ๐ณMarathi
- ms๐ฒ๐พMalay
- my๐ฒ๐ฒBurmese
- nl๐ณ๐ฑDutch
- nl-BE๐ง๐ชFlemish
- nl-NL๐ณ๐ฑDutch (Netherlands)
- no๐ณ๐ดNorwegian
- pa๐ฎ๐ณPunjabi
- pl๐ต๐ฑPolish
- pt๐ง๐ทPortuguese
- pt-BR๐ง๐ทBrazilian Portuguese
- pt-PT๐ต๐นEuropean Portuguese
- qbr๐qbr
- ro๐ท๐ดRomanian
- ru๐ท๐บRussian
- sk๐ธ๐ฐSlovak
- sl๐ธ๐ฎSlovenian
- so๐ธ๐ดSomali
- sq๐ฆ๐ฑAlbanian
- sr๐ท๐ธSerbian
- sv๐ธ๐ชSwedish
- sw๐น๐ฟSwahili
- sw-KE๐ฐ๐ชSwahili (Kenya)
- sw-TZ๐น๐ฟSwahili (Tanzania)
- ta๐ฎ๐ณTamil
- te๐ฎ๐ณTelugu
- th๐น๐ญThai
- tl๐ต๐ญFilipino
- tr๐น๐ทTurkish
- uk๐บ๐ฆUkrainian
- ur๐ต๐ฐUrdu
- vi๐ป๐ณVietnamese
- zh๐จ๐ณChinese
- zh-CN๐จ๐ณChinese (China)
- zh-HK๐ญ๐ฐChinese (Hong Kong SAR China)
- zh-Hans๐จ๐ณSimplified Chinese
- zh-Hant๐น๐ผTraditional Chinese
- zh-SG๐ธ๐ฌChinese (Singapore)
- zh-TW๐น๐ผChinese (Taiwan)
Notes
- General Translation uses Locale Tags (locales) to identify languages and regions internally.
Next steps
- See our list of supported locales to find the language tags available in General Translation.
- Refer to the official IETF Language Tag Registry and the BCP 47 language tag standard for more information.
How is this guide?