Skip to content
Tutorials Center
My learning

Topics

HTML Reference · Characters and Codes

HTML Language Codes

How lang attribute values work in HTML: BCP 47 language tags with script and region subtags, plus a table of 142 ISO 639-1 language codes with native names.

The lang attribute tells browsers, screen readers, search engines and translation tools which language an element's text is in. Its value is a language tag in the BCP 47 format, the same format used by hreflang, the Accept-Language HTTP header and JavaScript's Intl APIs.

HTML
<html lang="en">
  ...
  <p>The French word <span lang="fr">flâneur</span> has no exact English equivalent.</p>

Setting the right language changes real behavior: screen readers switch pronunciation, hyphens: auto uses the right dictionary, <q> picks the right quotation marks, fonts for Chinese, Japanese and Korean can differ, and browsers offer to translate only when the language differs from the reader's.

How a language tag is built

A tag is made of subtags joined by hyphens. Only the first one is required:

TEXT
language [-script] [-region] [-variant] [-extension] [-x-private]
   zh    -  Hant   -   TW
   en               -   US
   sr    -  Latn
   es               -  419
Subtag Format Examples Meaning
Language 2 letters (ISO 639-1) or 3 letters (ISO 639-2/3) en, fr, fil, yue The language itself. Use the two-letter code when one exists.
Script 4 letters, title case (ISO 15924) Latn, Cyrl, Hans The writing system, for languages written in more than one.
Region 2 letters, uppercase (ISO 3166-1), or 3 digits (UN M.49) US, BR, 419 A regional variety, such as spelling, vocabulary or formats.
Variant 5–8 characters, or 4 starting with a digit 1996, valencia A registered dialect or orthography.
Private use x- followed by anything en-x-pirate Your own meaning; no one else will understand it.

Tags are case-insensitive (EN-us works), but the conventional casing shown above is easier to read.

Try it

Type a tag to see how the browser understands it. The quote marks and the name come from the browser's own language data.

Language tag explorer

Try de, fr-CA, ja, zh-Hant-TW, sr-Cyrl or es-419, and watch the quotation marks change.

ISO 639-1 language codes

These are 142 of the most widely used two-letter codes. "rtl" marks languages normally written right to left; give those elements dir="rtl" as well as lang.

Codes A – E

Code Language Native name Direction Notes and example tags
af Afrikaans Afrikaans ltr
ak Akan Akan ltr
am Amharic አማርኛ ltr
ar Arabic العربية rtl ar-EG, ar-SA
as Assamese অসমীয়া ltr
ay Aymara Aymar aru ltr
az Azerbaijani azərbaycan ltr az-Latn, az-Cyrl
be Belarusian беларуская ltr
bg Bulgarian български ltr
bm Bambara bamanakan ltr
bn Bengali (Bangla) বাংলা ltr bn-BD, bn-IN
bo Tibetan བོད་སྐད་ ltr
br Breton brezhoneg ltr
bs Bosnian bosanski ltr bs-Latn, bs-Cyrl
ca Catalan català ltr
ce Chechen нохчийн ltr
co Corsican corsu ltr
cs Czech čeština ltr
cy Welsh Cymraeg ltr
da Danish dansk ltr
de German Deutsch ltr de-DE, de-AT, de-CH
dv Divehi ދިވެހި rtl
dz Dzongkha རྫོང་ཁ ltr
ee Ewe eʋegbe ltr
el Greek Ελληνικά ltr
en English English ltr en-US, en-GB, en-IN, en-AU
eo Esperanto Esperanto ltr Constructed language
es Spanish español ltr es-ES, es-MX, es-419
et Estonian eesti ltr
eu Basque euskara ltr

Codes F – J

Code Language Native name Direction Notes and example tags
fa Persian فارسی rtl
ff Fula Pulaar ltr
fi Finnish suomi ltr
fj Fijian Vosa Vakaviti ltr
fo Faroese føroyskt ltr
fr French français ltr fr-FR, fr-CA, fr-CH
fy Western Frisian Frysk ltr
ga Irish Gaeilge ltr
gd Scottish Gaelic Gàidhlig ltr
gl Galician galego ltr
gn Guarani Avañeʼẽ ltr
gu Gujarati ગુજરાતી ltr
gv Manx Gaelg ltr
ha Hausa Hausa ltr
he Hebrew עברית rtl Old documents may use the withdrawn code iw
hi Hindi हिन्दी ltr hi-IN
hr Croatian hrvatski ltr
ht Haitian Creole créole haïtien ltr
hu Hungarian magyar ltr
hy Armenian հայերեն ltr
ia Interlingua interlingua ltr Constructed language
id Indonesian Indonesia ltr Old documents may use the withdrawn code in
ig Igbo Igbo ltr
is Icelandic íslenska ltr
it Italian italiano ltr it-IT, it-CH
iu Inuktitut ᐃᓄᒃᑎᑐᑦ ltr
ja Japanese 日本語 ltr ja-JP
jv Javanese Jawa ltr

Codes K – M

Code Language Native name Direction Notes and example tags
ka Georgian ქართული ltr
kk Kazakh қазақ тілі ltr
kl Kalaallisut kalaallisut ltr
km Khmer ខ្មែរ ltr
kn Kannada ಕನ್ನಡ ltr
ko Korean 한국어 ltr ko-KR
ks Kashmiri کٲشُر rtl Also written in Devanagari
ku Kurdish kurdî (kurmancî) ltr ku-Arab is written right to left
kw Cornish kernewek ltr
ky Kyrgyz кыргызча ltr
la Latin Latina ltr Classical language
lb Luxembourgish Lëtzebuergesch ltr
lg Ganda Luganda ltr
ln Lingala lingála ltr
lo Lao ລາວ ltr
lt Lithuanian lietuvių ltr
lv Latvian latviešu ltr
mg Malagasy Malagasy ltr
mi Māori Māori ltr
mk Macedonian македонски ltr
ml Malayalam മലയാളം ltr
mn Mongolian монгол ltr mn-Cyrl, mn-Mong
mr Marathi मराठी ltr
ms Malay Melayu ltr ms-MY, ms-SG
mt Maltese Malti ltr
my Burmese မြန်မာ ltr

Codes N – R

Code Language Native name Direction Notes and example tags
nb Norwegian Bokmål norsk bokmål ltr nb-NO
ne Nepali नेपाली ltr
nl Dutch Nederlands ltr nl-NL, nl-BE
nn Norwegian Nynorsk norsk nynorsk ltr
no Norwegian norsk ltr Umbrella code; nb and nn are its two written standards
ny Chichewa (Nyanja) Chichewa ltr
oc Occitan occitan ltr
om Oromo Oromoo ltr
or Odia ଓଡ଼ିଆ ltr
pa Punjabi ਪੰਜਾਬੀ ltr pa-Guru, pa-Arab
pl Polish polski ltr
ps Pashto پښتو rtl
pt Portuguese português ltr pt-BR, pt-PT
qu Quechua Runasimi ltr
rm Romansh rumantsch ltr
rn Rundi Ikirundi ltr
ro Romanian română ltr
ru Russian русский ltr ru-RU
rw Kinyarwanda Ikinyarwanda ltr

Codes S – T

Code Language Native name Direction Notes and example tags
sa Sanskrit संस्कृत भाषा ltr Classical language
sc Sardinian sardu ltr
sd Sindhi سنڌي rtl
se Northern Sami davvisámegiella ltr
si Sinhala සිංහල ltr
sk Slovak slovenčina ltr
sl Slovenian slovenščina ltr
sm Samoan Gagana Samoa ltr
sn Shona chiShona ltr
so Somali Soomaali ltr
sq Albanian shqip ltr
sr Serbian српски ltr sr-Cyrl, sr-Latn
st Southern Sotho Sesotho ltr
su Sundanese Basa Sunda ltr
sv Swedish svenska ltr
sw Swahili Kiswahili ltr sw-KE, sw-TZ
ta Tamil தமிழ் ltr
te Telugu తెలుగు ltr
tg Tajik тоҷикӣ ltr
th Thai ไทย ltr
ti Tigrinya ትግርኛ ltr
tk Turkmen türkmen dili ltr
tl Tagalog Tagalog ltr Filipino is usually tagged fil
tn Tswana Setswana ltr
to Tongan lea fakatonga ltr
tr Turkish Türkçe ltr
ts Tsonga Xitsonga ltr
tt Tatar татар ltr

Codes U – Z

Code Language Native name Direction Notes and example tags
ug Uyghur ئۇيغۇرچە rtl
uk Ukrainian українська ltr
ur Urdu اردو rtl
uz Uzbek o‘zbek ltr uz-Latn, uz-Cyrl
vi Vietnamese Tiếng Việt ltr
wo Wolof Wolof ltr
xh Xhosa IsiXhosa ltr
yi Yiddish ייִדיש rtl Old documents may use the withdrawn code ji
yo Yoruba Èdè Yorùbá ltr
zh Chinese 中文 ltr zh-Hans, zh-Hant, zh-CN, zh-TW
zu Zulu isiZulu ltr

Script subtags

Add a script only when a language is commonly written in more than one script; ru-Cyrl and en-Latn add nothing.

Subtag Script Typical use
Latn Latin sr-Latn, az-Latn, uz-Latn
Cyrl Cyrillic sr-Cyrl, az-Cyrl, mn-Cyrl
Arab Arabic pa-Arab, ku-Arab, ms-Arab
Hans Han (Simplified) zh-Hans: mainland China and Singapore
Hant Han (Traditional) zh-Hant: Taiwan, Hong Kong and Macau
Deva Devanagari ks-Deva, sd-Deva
Guru Gurmukhi pa-Guru
Mong Mongolian mn-Mong
Hebr Hebrew yi-Hebr (rarely needed)
Grek Greek Greek text inside another language's document
Jpan Japanese (Han + Hiragana + Katakana) Mostly used in fonts and technical metadata
Kore Korean (Hangul + Han) Mostly used in fonts and technical metadata

Region subtags

Subtag Region Example tags
US United States en-US, es-US
GB United Kingdom en-GB, cy-GB
CA Canada en-CA, fr-CA
AU Australia en-AU
IN India en-IN, hi-IN, ta-IN
IE Ireland en-IE, ga-IE
DE Germany de-DE
AT Austria de-AT
CH Switzerland de-CH, fr-CH, it-CH
FR France fr-FR
BE Belgium fr-BE, nl-BE
ES Spain es-ES, ca-ES
MX Mexico es-MX
419 Latin America and the Caribbean es-419
BR Brazil pt-BR
PT Portugal pt-PT
CN China zh-CN
TW Taiwan zh-TW
HK Hong Kong zh-HK, en-HK
JP Japan ja-JP
KR South Korea ko-KR
EG Egypt ar-EG
SA Saudi Arabia ar-SA

Special values

Value Meaning
lang="" The language is unknown. Use it to stop an element from inheriting the page language.
und Undetermined language (used mostly in data, rarely in HTML).
zxx No linguistic content, such as a code sample or a list of product numbers.
mul Multiple languages.
fil, yue, haw, ast Three-letter codes for languages without a two-letter code: Filipino, Cantonese, Hawaiian, Asturian.

Usage notes

  • Always set lang on <html>. It is the single most useful language hint, and accessibility checkers flag pages without it.
  • Mark changes of language inline. Wrap foreign phrases in an element with its own lang, so screen readers pronounce them correctly.
  • Keep tags as short as possible. Use en unless the regional difference matters, as with en-US vs en-GB spelling or pt-BR vs pt-PT.
  • Language is not country. en-IN is English as used in India; there is no tag that means "India". Don't put a country code in the language position: lang="uk" means Ukrainian, not the United Kingdom. British English is en-GB.
  • Direction is separate. lang="ar" does not flip the text direction; add dir="rtl" (or dir="auto" for user content).
  • Translated pages should be linked to each other with <link rel="alternate" hreflang="…">, which uses the same tags.