Template:Native name/doc

This is a documentation subpage for Template:Native name.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 23,000 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:

For {{native name}} error messages appearing in various infoboxes, see Wikipedia talk:WikiProject Infoboxes/Archive 11#native name parameters.

An inline formatting template, based on {{Lang}}, for indicating the official/defacto name in a language other than English. By default, the native name is displayed in italics, followed by the language's name in parentheses.

The template's defaults can be overridden and the parenthesis excluded, in which case there may be no visible changes to the text where it's used. An HTML span, however, still identifies the native name as a linguistic element, meaning that web browsers and screen readers can select a particular font, formatting, pronunciation, etc., for it.

For multiple native names, use {{native name list}}

Syntax

{{Native name|<IETF language tag>|<the native name>}}

Parameters

Parameter name	Description and examples	Required
[first unnamed]	The IETF language tag code for the native language. French, for instance, is "fr"; Spanish is "es"; Arabic is "ar"; etc.	yes
[second unnamed]	The native name, in the native language (with accents, etc.).	yes
`italics` (or `italic`)	Set to "off" or "no" to disable displaying the native name in italics. Example: `\|italics=off`	no
`paren` (or `icon`)	Set to "omit", "off" or "no" to suppress the appearance of the native language's name in a parenthesis after the native name. Example: `\|paren=omit`	no
`parensize` (previously `fontsize`)	Use to specify a font-size for the parenthesis. Per MOS:FONTSIZE, do not make this text smaller in infoboxes, since the text is already at 88% of normal. Example: `\|parensize=90%`	no
`nolink`	Set to anything (e.g. "on") to suppress the appearance of the native language's name as a link.	no
`script` (deprecated)	when needed, include ISO 15924 in `{{{1}}}` IETF language tag; e.g. 'sr-Cyrl' ~~Specifies the ISO 15924 script. E.g. "Cyrl", "Arab", "Hans"...~~	no

Examples

Common usage:
- {{Native name|de|Deutschland}} –> Deutschland (German)

Code and result for the same name "Deutschland" above but with italics switched off, nolink switched on and a parensize of 90%:
- {{Native name|de|Deutschland|italics=off|nolink=on|parensize=90%}} –> Deutschland (German)

Retaining no italics but suppressing the parenthesis which produces the same as if the {{lang}} template had been used:
- {{Native name|de|Deutschland|italics=off|paren=omit}} –> Deutschland

Language does not have an ISO code
- {{Native name|mis|Banib|paren=omit}} ([[Boonwurrung language]]) –> Banib (Boonwurrung language)

Language is not known
- {{Native name|und|Bakoma|paren=omit}} –> Bakoma

Other examples

Code

Result

{{Infobox settlement
| name = The Hague
| native_name = {{Native name|nl|Den Haag}}
}}

{{Infobox country
| conventional_long_name = French Republic
| native_name = {{Native name|fr|République française|paren=omit}}
}}

Tracking category

Category:Native name template errors (0)

Template data

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Native name in articles based on its TemplateData.

TemplateData for Native name

Foreign language name formatting

Template parameters
Parameter		Description	Type	Status
language	`tag`	language code Example el, de	String	required
name	`name`	Name in foreign language (use ISO 639 language codes) Example ευρώ, herzlich willkommen	String	required
italics	`italic` `italics`	"off" will prevent italicising the name Default on	Boolean	optional
language name	`paren`	Language name in parenthesis Default on	Boolean	optional
language fontsize	`parensize`	font-size of the language (parenthesised) Example 90%	Number	optional