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 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:
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.
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
langon<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
enunless the regional difference matters, as withen-USvsen-GBspelling orpt-BRvspt-PT. - Language is not country.
en-INis 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 isen-GB. - Direction is separate.
lang="ar"does not flip the text direction; adddir="rtl"(ordir="auto"for user content). - Translated pages should be linked to each other with
<link rel="alternate" hreflang="…">, which uses the same tags.
Related
- Global attributes –
lang,dirandtranslate <html>– where the page language is set<bdi>– isolating text of unknown direction<q>– language-aware quotation marks- Lesson: Accessibility Basics
- Lesson: Meta Tags