Supported Languages

Translazor supports multiple target languages using language codes.

The currently supported language codes are validated against the configured translation provider. By default, Translazor validates languages against the Azure Translator supported language list.

Configure supported languages

Add the languages you want to support in appsettings.json.

{
  "Translazor": {
    "Translation": {
      "DefaultSourceLanguage": "en",
      "FallbackLanguage": "en",
      "SupportedLanguages": [ "en", "ar", "fr", "de", "lt" ]
    }
  }
}

Important

Only add languages that are supported by your configured translation provider.

Some translation providers use different language codes for the same language. For example:

Language	Azure code	Other common/provider-specific code
Hebrew	he	iw
Filipino	fil	tl
Chinese Simplified	zh-Hans	zh-CN
Chinese Traditional	zh-Hant	zh-TW
Norwegian Bokmål	nb	no
Nyanja / Chichewa	nya	ny
Kurdish (Northern)	kmr	ku / provider-specific variants

tip

Start with a small set of languages first. After confirming that translation, caching, routing, and SEO metadata work correctly, you can add more languages.

Recommended starter configuration

{
  "Translazor": {
    "Translation": {
      "DefaultSourceLanguage": "en",
      "FallbackLanguage": "en",
      "SupportedLanguages": [ "en", "ar", "fr", "de", "lt" ]
    }
  }
}

Commonly used languages

Code	Language
en	English
ar	Arabic
fr	French
de	German
es	Spanish
it	Italian
pt	Portuguese
pt-PT	Portuguese (Portugal)
nl	Dutch
sv	Swedish
da	Danish
fi	Finnish
pl	Polish
ro	Romanian
lt	Lithuanian
lv	Latvian
et	Estonian
uk	Ukrainian
ru	Russian
tr	Turkish
he	Hebrew
hi	Hindi
ja	Japanese
ko	Korean
zh-Hans	Chinese Simplified
zh-Hant	Chinese Traditional

Full Azure-supported language table

The following language codes are supported by Translazor when using the default Azure Translator provider.

Code	Language
af	Afrikaans
am	Amharic
ar	Arabic
as	Assamese
az	Azerbaijani
ba	Bashkir
be	Belarusian
bg	Bulgarian
bho	Bhojpuri
bn	Bengali
bo	Tibetan
brx	Bodo
bs	Bosnian
ca	Catalan
cs	Czech
cy	Welsh
da	Danish
de	German
doi	Dogri
dsb	Lower Sorbian
dv	Divehi
el	Greek
en	English
es	Spanish
et	Estonian
eu	Basque
fa	Persian
fi	Finnish
fil	Filipino
fj	Fijian
fo	Faroese
fr	French
fr-CA	French (Canada)
ga	Irish
gl	Galician
gom	Konkani
gu	Gujarati
ha	Hausa
he	Hebrew
hi	Hindi
hne	Chhattisgarhi
hr	Croatian
hsb	Upper Sorbian
ht	Haitian Creole
hu	Hungarian
hy	Armenian
id	Indonesian
ig	Igbo
ikt	Inuinnaqtun
is	Icelandic
it	Italian
iu	Inuktitut
iu-Latn	Inuktitut (Latin)
ja	Japanese
ka	Georgian
kk	Kazakh
km	Khmer
kmr	Kurdish (Northern)
kn	Kannada
ko	Korean
ks	Kashmiri
ku	Kurdish
ky	Kyrgyz
lb	Luxembourgish
ln	Lingala
lo	Lao
lt	Lithuanian
lug	Ganda
lv	Latvian
lzh	Literary Chinese
mai	Maithili
mg	Malagasy
mi	Maori
mk	Macedonian
ml	Malayalam
mn-Cyrl	Mongolian (Cyrillic)
mn-Mong	Mongolian (Traditional)
mni	Manipuri
mr	Marathi
ms	Malay
mt	Maltese
mww	Hmong Daw
my	Myanmar (Burmese)
nb	Norwegian Bokmål
ne	Nepali
nl	Dutch
nso	Sepedi
nya	Nyanja
or	Odia
otq	Querétaro Otomi
pa	Punjabi
pl	Polish
prs	Dari
ps	Pashto
pt	Portuguese
pt-PT	Portuguese (Portugal)
ro	Romanian
ru	Russian
run	Rundi
rw	Kinyarwanda
sd	Sindhi
si	Sinhala
sk	Slovak
sl	Slovenian
sm	Samoan
sn	Shona
so	Somali
sq	Albanian
sr-Cyrl	Serbian (Cyrillic)
sr-Latn	Serbian (Latin)
st	Sesotho
sv	Swedish
sw	Swahili
ta	Tamil
te	Telugu
th	Thai
ti	Tigrinya
tk	Turkmen
tlh-Latn	Klingon (Latin)
tlh-Piqd	Klingon (pIqaD)
tn	Setswana
to	Tongan
tr	Turkish
tt	Tatar
ty	Tahitian
ug	Uyghur
uk	Ukrainian
ur	Urdu
uz	Uzbek
vi	Vietnamese
xh	Xhosa
yo	Yoruba
yua	Yucatec Maya
yue	Cantonese
zh-Hans	Chinese Simplified
zh-Hant	Chinese Traditional
zu	Zulu

Example: language selector

You can render a language selector in your Blazor application:

<LanguageSelector />

The selector should only expose languages that are both:

1. Listed in your SupportedLanguages configuration.
2. Supported by your configured translation provider.

Example: language-specific routes

If your application uses language-specific URLs, keep the route language code consistent with the configured language codes.

Examples:

/ar/home
/fr/home
/lt/home

For Chinese, use Azure-compatible codes:

/zh-Hans/home
/zh-Hant/home

Related pages

• Quickstart
• Language Switching
• Translating Page Content
• Translating Head and SEO Metadata