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., en for English, es for Spanish.
  • Region subtag: Specifies a country or region, e.g., US for the United States, FR for France.
  • Script subtag (optional): Indicates the writing script, e.g., Latn for Latin script.
  • Variant subtag (optional): Identifies a specific variation of a language, e.g., arevela for 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 TagDescription
en-USEnglish as used in the US
es-ESSpanish as used in Spain
fr-CAFrench as used in Canada
zh-CNSimplified Chinese (China)
de-DEGerman as used in Germany

Extended Tags

Language tags can include additional subtags for greater specificity:

  • Example: hy-Latn-IT-arevela
    • hy: 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

How is this guide?

Locales