Template documentation[view] [edit] [history] [purge]

This template is used on approximately 8,300 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

This template uses Lua:

Module:ISO 639 name (sandbox)

Language templates
Language names (ISO 639)
((ISO 639 name))
Interwiki links
((Wikt-lang)) Module:Language ((Interlanguage link))
Foreign-language text
((Lang)) Module:Lang ((Transliteration)) ((Title language)) ((PIE))
Other
((IPA)) Module:Language/data
v t e

Usage

The ((ISO 639 name)) template is used to resolve ISO 639-1, ISO 639-2, ISO 639-3 and ISO 639-5 codes to language names. It will trim extraneous IETF language tags to just the ISO 639 code. E.g.: Sanskrit in Latin script, which IETF language tag is sa-Latn, renders as:

((ISO 639 name|sa-Latn)) → Sanskrit error: sa-Latn is an IETF tag (help)

The error message can be suppressed with |hide-err=yes:

((ISO 639 name|sa-Latn|hide-err=yes)) → Sanskrit

The rendered language name can be linked to the appropriate language article with |link=yes:

((ISO 639 name|sa-Latn|hide-err=yes|link=yes)) → Sanskrit

When linking, an alternate link label can be provided with |label=<label text>:

((ISO 639 name|sa-Latn|hide-err=yes|link=yes|label=sa-Latn)) → sa-Latn

The ((ISO 639 name link)) template is the same as ((ISO 639 name)) except that it presets |link=yes.

Both of these templates can be safely substituted.

Other functions

This template can be used to execute any of the functions exported by Module:ISO 639 name. These function are:

iso_639_code_exists – returns true if <code> is found in any of the ISO 639 data tables
iso_639_code_to_name – (default) as described above
iso_639_code_1_to_name – same as iso_639_code_to_name except constrained to the ISO 639-1 data table
iso_639_code_2_to_name – same as iso_639_code_to_name except constrained to the ISO 639-2 data table
iso_639_code_2B_to_name – same as iso_639_code_to_name except constrained to the ISO 639-2B data table
iso_639_code_3_to_name – same as iso_639_code_to_name except constrained to the ISO 639-3 data table
iso_639_code_5_to_name – same as iso_639_code_to_name except constrained to the ISO 639-5 data table
iso_639_name_exists – returns true if <name> is found in any of the ISO 639 data tables
iso_639_name_to_code – returns language code associated with <name>; may be constrained to a particular ISO 639 data table
iso_639 – returns language name when given a valid language code; returns a language code when given a valid language name; may be constrained to a particular ISO 639 data table

To use these functions set |fn= to the appropriate function name.

Language codes

ISO 639-1 codes and matching codes from ISO 639-2, -2B, and -3
ISO 639-1	ISO 639-2	ISO 639-2B^[a]	ISO 639-3	Name	Article
aa	aar		aar	Afar	Afar
ab	abk		abk	Abkhazian	Abkhazian
ae	ave		ave	Avestan	Avestan
af	afr		afr	Afrikaans	Afrikaans
ak	aka		aka	Akan	Akan
am	amh		amh	Amharic	Amharic
an	arg		arg	Aragonese	Aragonese
ar	ara		ara	Arabic	Arabic
as	asm		asm	Assamese	Assamese
av	ava		ava	Avaric	Avaric
ay	aym		aym	Aymara	Aymara
az	aze		aze	Azerbaijani	Azerbaijani
ba	bak		bak	Bashkir	Bashkir
be	bel		bel	Belarusian	Belarusian
bg	bul		bul	Bulgarian	Bulgarian
bh	bih		^[b]	Bihari languages	Bihari languages
bi	bis		bis	Bislama	Bislama
bm	bam		bam	Bambara	Bambara
bn	ben		ben	Bengali	Bengali
bo	bod	tib	bod	Standard Tibetan	Standard Tibetan
br	bre		bre	Breton	Breton
bs	bos		bos	Bosnian	Bosnian
ca	cat		cat	Catalan	Catalan
ce	che		che	Chechen	Chechen
ch	cha		cha	Chamorro	Chamorro
co	cos		cos	Corsican	Corsican
cr	cre		cre	Cree	Cree
cs	ces	cze	ces	Czech	Czech
cu	chu		chu	Church Slavic	Church Slavic
cv	chv		chv	Chuvash	Chuvash
cy	cym	wel	cym	Welsh	Welsh
da	dan		dan	Danish	Danish
de	deu	ger	deu	German	German
dv	div		div	Dhivehi	Dhivehi
dz	dzo		dzo	Dzongkha	Dzongkha
ee	ewe		ewe	Ewe	Ewe
el	ell	gre	ell	Greek	Greek
en	eng		eng	English	English
eo	epo		epo	Esperanto	Esperanto
es	spa		spa	Spanish	Spanish
et	est		est	Estonian	Estonian
eu	eus	baq	eus	Basque	Basque
fa	fas	per	fas	Persian	Persian
ff	ful		ful	Fulah	Fulah
fi	fin		fin	Finnish	Finnish
fj	fij		fij	Fijian	Fijian
fo	fao		fao	Faroese	Faroese
fr	fra	fre	fra	French	French
fy	fry		fry	Western Frisian	Western Frisian
ga	gle		gle	Irish	Irish
gd	gla		gla	Scottish Gaelic	Scottish Gaelic
gl	glg		glg	Galician	Galician
gn	grn		grn	Guarani	Guarani
gu	guj		guj	Gujarati	Gujarati
gv	glv		glv	Manx	Manx
ha	hau		hau	Hausa	Hausa
he	heb		heb	Hebrew	Hebrew
hi	hin		hin	Hindi	Hindi
ho	hmo		hmo	Hiri Motu	Hiri Motu
hr	hrv	scr	hrv	Croatian	Croatian
ht	hat		hat	Haitian Creole	Haitian Creole
hu	hun		hun	Hungarian	Hungarian
hy	hye	arm	hye	Armenian	Armenian
hz	her		her	Herero	Herero
ia	ina		ina	Interlingua	Interlingua
id	ind		ind	Indonesian	Indonesian
ie	ile		ile	Interlingue	Interlingue
ig	ibo		ibo	Igbo	Igbo
ii	iii		iii	Sichuan Yi	Sichuan Yi
ik	ipk		ipk	Inupiaq	Inupiaq
io	ido		ido	Ido	Ido
is	isl	ice	isl	Icelandic	Icelandic
it	ita		ita	Italian	Italian
iu	iku		iku	Inuktitut	Inuktitut
ja	jpn		jpn	Japanese	Japanese
jv	jav	jaw	jav	Javanese	Javanese
ka	kat	geo	kat	Georgian	Georgian
kg	kon		kon	Kongo	Kongo
ki	kik		kik	Kikuyu	Kikuyu
kj	kua		kua	Kuanyama	Kuanyama
kk	kaz		kaz	Kazakh	Kazakh
kl	kal		kal	Kalaallisut	Kalaallisut
km	khm		khm	Khmer	Khmer
kn	kan		kan	Kannada	Kannada
ko	kor		kor	Korean	Korean
kr	kau		kau	Kanuri	Kanuri
ks	kas		kas	Kashmiri	Kashmiri
ku	kur		kur	Kurdish	Kurdish
kv	kom		kom	Komi	Komi
kw	cor		cor	Cornish	Cornish
ky	kir		kir	Kirghiz	Kirghiz
la	lat		lat	Latin	Latin
lb	ltz		ltz	Luxembourgish	Luxembourgish
lg	lug		lug	Ganda	Ganda
li	lim		lim	Limburgan	Limburgan
ln	lin		lin	Lingala	Lingala
lo	lao		lao	Lao	Lao
lt	lit		lit	Lithuanian	Lithuanian
lu	lub		lub	Luba-Katanga	Luba-Katanga
lv	lav		lav	Latvian	Latvian
mg	mlg		mlg	Malagasy	Malagasy
mh	mah		mah	Marshallese	Marshallese
mi	mri	mao	mri	Maori	Maori
mk	mkd	mac	mkd	Macedonian	Macedonian
ml	mal		mal	Malayalam	Malayalam
mn	mon		mon	Mongolian	Mongolian
mr	mar		mar	Marathi	Marathi
ms	msa	may	msa	Malay	Malay
mt	mlt		mlt	Maltese	Maltese
my	mya	bur	mya	Burmese	Burmese
na	nau		nau	Nauru	Nauru
nb	nob		nob	Norwegian Bokmål	Norwegian Bokmål
nd	nde		nde	North Ndebele	North Ndebele
ne	nep		nep	Nepali	Nepali
ng	ndo		ndo	Ndonga	Ndonga
nl	nld	dut	nld	Dutch	Dutch
nn	nno		nno	Norwegian Nynorsk	Norwegian Nynorsk
no	nor		nor	Norwegian	Norwegian
nr	nbl		nbl	South Ndebele	South Ndebele
nv	nav		nav	Navajo	Navajo
ny	nya		nya	Nyanja	Nyanja
oc	oci		oci	Occitan	Occitan
oj	oji		oji	Ojibwa	Ojibwa
om	orm		orm	Oromo	Oromo
or	ori		ori	Oriya	Oriya
os	oss		oss	Ossetian	Ossetian
pa	pan		pan	Panjabi	Panjabi
pi	pli		pli	Pali	Pali
pl	pol		pol	Polish	Polish
ps	pus		pus	Pushto	Pushto
pt	por		por	Portuguese	Portuguese
qu	que		que	Quechua	Quechua
rm	roh		roh	Romansh	Romansh
rn	run		run	Rundi	Rundi
ro	ron	rum	ron	Romanian	Romanian
ru	rus		rus	Russian	Russian
rw	kin		kin	Kinyarwanda	Kinyarwanda
sa	san		san	Sanskrit	Sanskrit
sc	srd		srd	Sardinian	Sardinian
sd	snd		snd	Sindhi	Sindhi
se	sme		sme	Northern Sami	Northern Sami
sg	sag		sag	Sango	Sango
sh	^[b]		hbs	Serbo-Croatian	Serbo-Croatian
si	sin		sin	Sinhala	Sinhala
sk	slk	slo	slk	Slovak	Slovak
sl	slv		slv	Slovenian	Slovenian
sm	smo		smo	Samoan	Samoan
sn	sna		sna	Shona	Shona
so	som		som	Somali	Somali
sq	sqi	alb	sqi	Albanian	Albanian
sr	srp	scc	srp	Serbian	Serbian
ss	ssw		ssw	Swati	Swati
st	sot		sot	Sotho	Sotho
su	sun		sun	Sundanese	Sundanese
sv	swe		swe	Swedish	Swedish
sw	swa		swa	Swahili	Swahili
ta	tam		tam	Tamil	Tamil
te	tel		tel	Telugu	Telugu
tg	tgk		tgk	Tajik	Tajik
th	tha		tha	Thai	Thai
ti	tir		tir	Tigrinya	Tigrinya
tk	tuk		tuk	Turkmen	Turkmen
tl	tgl		tgl	Tagalog	Tagalog
tn	tsn		tsn	Tswana	Tswana
to	ton		ton	Tongan	Tongan
tr	tur		tur	Turkish	Turkish
ts	tso		tso	Tsonga	Tsonga
tt	tat		tat	Tatar	Tatar
tw	twi		twi	Twi	Twi
ty	tah		tah	Tahitian	Tahitian
ug	uig		uig	Uighur	Uighur
uk	ukr		ukr	Ukrainian	Ukrainian
ur	urd		urd	Urdu	Urdu
uz	uzb		uzb	Uzbek	Uzbek
ve	ven		ven	Venda	Venda
vi	vie		vie	Vietnamese	Vietnamese
vo	vol		vol	Volapük	Volapük
wa	wln		wln	Walloon	Walloon
wo	wol		wol	Wolof	Wolof
xh	xho		xho	Xhosa	Xhosa
yi	yid		yid	Yiddish	Yiddish
yo	yor		yor	Yoruba	Yoruba
za	zha		zha	Zhuang	Zhuang
zh	zho	chi	zho	Chinese	Chinese
zu	zul		zul	Zulu	Zulu

Notes

^ There are only 20 ISO 639-2B codes.
^ ^a ^b Code not assigned.

Examples

((ISO 639 name|en)) gives English
((ISO 639 name|fr)) gives French

Error messages

This template produces error messages. These messages are:

<code> is an IETF tag – IETF language tags are not ISO 639 language codes. When these tags are encountered, the template attempts to render the correct language and also emits this error message
ISO 639-<part> code is required – where <part> is 1, 2, 3, 5; template was called without the required language code
<code> is not an ISO 639-<part> code – <code> fails simple length validation; 639 part 1, language codes are two characters, for 639 parts 2, 3, and 5, language codes are three characters
<code> not found in ISO 639-<part> list – <code> not found after searching ISO 639-<part> data

The module that does the work for this template has other functionality not supported by this template. See Module:ISO 639 name. Error messages related to that other functionality are:

language name required – module function iso_639_name_to_code() only – this message emitted when a language name is not provided in the ((#invoke:))
<part> not an ISO 639 part – module functions iso_639_name_to_code() and iso_639() only – this message emitted when <part> is not one of 1, 2, 3, or 5
language code or name required – module function iso_639() only – this message emitted when a language name or a language code is not provided in the ((#invoke:))

Tracking categories

Category:ISO 639 name template errors (15)