View source for Template:Disambiguation/doc

<noinclude>{{pp-vandalism|small=yes}}
</noinclude>{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[</nowiki>[[Wikipedia:Wikidata]]<nowiki>]]) -->
{{for|the inline tag|Template:Disambiguation needed}}
{{High-use}}
{{Nosubst}}
{{Dabnav}}
{{tsh|Dab|Disambig}}
This is the {{tl|Disambiguation}} template.

This is a general-purpose template, to be placed at the bottom of any article that exists to help readers find other articles with the same or similar names. This concept is called ''[[Wikipedia:Disambiguation|disambiguation]]'' and is used with many common words, such as ''[[Cross (disambiguation)|cross]]'', ''[[Life (disambiguation)|life]]'' and ''[[work]]''. This template automatically adds articles to the [[:Category:Disambiguation pages]].

== Page title fixes ==
This template will automatically detect incomplete disambiguation present in page titles. If the title includes anything other than (disambiguation) in parentheses, it is assumed to be the article type. For example, this template on the page [[1st Division (France)]] would produce the text "This disambiguation page lists France articles associated with the title '''1st Division'''". If the page title contains parentheses that are not used for disambiguation (such as [[Everything You Always Wanted to Know About Sex* (*But Were Afraid to Ask)]]), set {{para|ignore_parentheses|yes}}. If you wish to manually specify the article type, use the {{para|type}} parameter.

==Variant templates==
===Disambiguation===
{{Category see also|Disambiguation message boxes}}

For disambiguation pages requiring cleanup, use {{tl|Disambiguation cleanup}}.

More specific and alternative templates exist for disambiguation pages whose entries are limited exclusively to items of a particular type:
{|
|- style="text-align:left"
! Template !! Category !! Notes
|-
| {{tl|Airport disambiguation}} || [[:Category:Airport disambiguation pages]] || for airports
|-
| {{tl|Biology disambiguation}} || [[:Category:Biology disambiguation pages]]
|-
| {{tl|Call sign disambiguation}} || [[:Category:Broadcast call sign disambiguation pages]]
|-
| {{tl|Caselaw disambiguation}} || [[:Category:Case law disambiguation pages]]
|-
| {{tl|Chinese title disambiguation}} || [[:Category:Disambiguation pages with Chinese character titles]]
|-
| {{tl|Genus disambiguation}} || [[:Category:Genus disambiguation pages]]
|-
| {{tl|Human name disambiguation}}<br>{{pad}}{{tl|Human name disambiguation cleanup}} || [[:Category:Human name disambiguation pages]]
|-
|-
| {{tl|Hospital disambiguation}} || [[:Category:Hospital disambiguation pages]] || for hospitals or medical centers
|-
| {{tl|Letter–number combination disambiguation}} || [[:Category:Letter–number combination disambiguation pages]]
|-
| {{tl|Mathematical disambiguation}} || [[:Category:Mathematics disambiguation pages]] || for mathematics titles
|-
| {{tl|Military unit disambiguation}} || [[:Category:Military units and formations disambiguation pages]]
|-
| {{tl|Number disambiguation}} || [[:Category:Lists of ambiguous numbers]]
|-
| {{tl|Phonetics disambiguation}} || [[:Category:Linguistics disambiguation pages]]
|-
| {{tl|Place name disambiguation}} || [[:Category:Place name disambiguation pages]]
|-
| {{tl|Road disambiguation}} || [[:Category:Road disambiguation pages]]
|-
| {{tl|School disambiguation}} || [[:Category:Educational institution disambiguation pages]] || for educational institutions
|-
| {{tl|Species Latin name disambiguation}} || [[:Category:Latin name disambiguation pages]]
|-
| {{tl|Station disambiguation}} || [[:Category:Station disambiguation pages]] || for railway and public transport stations
|-
| {{tl|Synagogue disambiguation}} || [[:Category:Synagogue disambiguation pages]] || for synagogues
|}

'''Note:''' A set index article (SIA) is ''not'' a disambiguation page; it is a list article about a set of items ''of a specific type'' that ''also'' share the same (or similar) name. [[Wikipedia:Set index articles]] includes templates for SIAs.

== Parameters ==
Sometimes there isn't a specific disambiguation template (see list above) that fits for a page, or the page has items in more than one of the above classes. Then use {{tl|Disambiguation}} but with one or more parameters telling which categories to use. Up to ten parameters can be fed, and in any order. For example:

:{{tlc|Disambiguation|school|hospital}}
{|
|colspan=2| Only add a parameter from this list if the disambiguation page has '''several''' items of that type:
|-
|style="vertical-align:top"| {{tlx|Disambiguation|human name}}<br>{{pad}}{{tlx|Disambiguation|hn{{=}}''sortkey''}} || for [[:Category:Human name disambiguation pages]]<br>{{pad}}for [[:Category:Human name disambiguation pages]] with a specified [[WP:SORTKEY|sort key]] (e.g. {{tlx|Disambiguation|hn{{=}}Doe, John}})
|-
| {{tlx|Disambiguation|bird}} || for [[:Category:Bird common name disambiguation pages]]
|-
| {{tlx|Disambiguation|church}} || for [[:Category:Church building disambiguation pages]]
|-
|style="vertical-align:top"| {{tlx|Disambiguation|county}}<br>{{pad}}{{tlx|Disambiguation|uscounty}} || for [[:Category:County name disambiguation pages]]<br>{{pad}}for [[:Category:United States county name disambiguation pages]]
|-
| {{tlx|Disambiguation|fish}} || for [[:Category:Fish common name disambiguation pages]]
|-
| {{tlx|Disambiguation|genus}} || for [[:Category:Genus disambiguation pages]]
|-
| {{tlx|Disambiguation|geo}} || for [[:Category:Place name disambiguation pages]]
|-
| {{tlx|Disambiguation|hospital}} || for [[:Category:Hospital disambiguation pages]]
|-
| {{tlx|Disambiguation|latin}} || for [[:Category:Latin name disambiguation pages]]
|-
|style="white-space: nowrap;"| {{tlx|Disambiguation|letter number}} || for [[:Category:Letter–number combination disambiguation pages]]
|-
| {{tlx|Disambiguation|math}} || for [[:Category:Mathematics disambiguation pages]]
|-
| {{tlx|Disambiguation|number}} || for [[:Category:Lists of ambiguous numbers]]
|-
| {{tlx|Disambiguation|plant}} || for [[:Category:Plant common name disambiguation pages]]
|-
| {{tlx|Disambiguation|political}} || for [[:Category:Political party disambiguation pages]]
|-
| {{tlx|Disambiguation|road}} || for [[:Category:Road disambiguation pages]]
|-
| {{tlx|Disambiguation|school}} || for [[:Category:Educational institution disambiguation pages]]
|-
| {{tlx|Disambiguation|ship}} || for [[:Category:Ship disambiguation pages]]
|-
| {{tlx|Disambiguation|station}} || for [[:Category:Station disambiguation pages]]
|-
| {{tlx|Disambiguation|tndis}} || for [[:Category:Title and name disambiguation pages]]
|-
| {{tlx|Disambiguation|township}} || for [[:Category:Township name disambiguation pages]]
|-
|colspan=2| <br/>These can be added if there are '''one or more''' elements in the list (per their category descriptions):
|-
| {{tlx|Disambiguation|airport}} || for [[:Category:Airport disambiguation pages]]
|-
| {{tlx|Disambiguation|callsign}} || for [[:Category:Broadcast call sign disambiguation pages]]
|-
|colspan=2| <br/>These can be added even if there's '''only one''' element in the list, since these types are not actually ambiguous:
|-
| {{tlx|Disambiguation|given name}} || for [[:Category:Disambiguation pages with given-name-holder lists]]
|-
| {{tlx|Disambiguation|surname}} || for [[:Category:Disambiguation pages with surname-holder lists]]
|-
|colspan=2| <br/>This parameter reflects the '''title''', not the contents:
|-
| {{tlx|Disambiguation|chinese}} || for [[:Category:Disambiguation pages with Chinese character titles]]
|-
|colspan=2| <br/>And this parameter reflects a '''maintenance need''', not the contents:
|-
| {{tlx|Disambiguation|split}} || for [[:Category:Disambiguation pages in need of being split]]
{{!}}}

Note that {{tl|Disambiguation}} might not have parameters for all subcategories of [[:Category:Disambiguation pages]]; the category may have to be manually added to the disambiguation page.

=== Nocat ===
If categorization is not needed on pages that are not in [[WP:MAINSPACE|mainspace]], then the "nocat" parameter may be set equal to "true" or "yes" as follows:
* {{tlx|Disambiguation|nocat{{=}}true}}
* {{tlx|Disambiguation|nocat{{=}}yes}}

== Redirects ==
The following redirect to this template:

* {{tl|Disambig}}
* {{tl|Dab}}
* {{tl|Disamb}}

== Technical details ==
Internally, this template uses {{tl|Dmbox}}. That template categorises pages into [[:Category:All disambiguation pages]] and [[:Category:All article disambiguation pages]].

This template also uses {{tl|Disambiguation/cat}} to handle the categorisation parameters, such as "hospital" and "school".

Other templates and modules used:
* {{tl|Disambiguation page short description}}
* {{tl|Template other}}
* {{tl|Title disambig text}}
* {{tl|PAGENAMEBASE}}
* {{tl|Trim}}
* {{tl|Str rep}}
* {{module link|Redirect|isRedirect}}

== Template use ==
Place template at the foot of the disambiguation page after all of the disambiguation content but before any categories (see below) (interlanguage links to Wikidata), as per the [[WP:DCAT]] guideline.

==TemplateData==
{{TemplateData header}}
<templatedata>
{
	"description": "Place at the bottom of Disambiguation pages.",
	"params": {
		"1": {
			"label": "First category key",
			"description": "Used to put the page in a category. Can be one of 'split' (dab pages in need of being split); 'clean up','clean-up','cleanup' (dabs in need of cleanup); 'airports','airport' (airport dabs); 'call sign','call signs','broadcast call sign','broadcast call signs','callsign' (broadcast call sign dabs); 'chinese char','chinese-char','chinesechar','chinese character','chinese' (chinese character dabs); 'churches','church building','church buildings','church' (church building dabs), 'fish' (fish dabs); 'geodis','geography','geographical','place name','place names','place','places','geo' (Place names); 'county'; 'uscounty' (United States county dabs); 'township' (Township name dabs); 'name','names','human name','human names','hn','hndis' (Human name dabs); 'surnames','surname' (surname dabs); 'given names','given name' (given-name dabs), 'hospital name','hospital names','hospitals','hospital' (hospital dabs); 'latin name','latin names','latin' (Latin name dabs); 'letter-number','letter number' (Letter-number combination dabs); 'mathdab','maths','mathematics','mathematical','math' (mathematical dabs); 'numberdis','numbers','ambiguous number','ambiguous numbers','number' (Lists of ambiguous numbers), 'plants','plant' (Plant common name dabs); 'roaddis','roads','road' (road dabs), 'schooldis','schools','educational institution','educational institutions','college','colleges','university','universities','school' (Educational institution dabs); 'political','party' (political party dabs), 'genus' (Genus dabs)",
			"type": "string",
			"required": false,
			"suggestedvalues": [
				"split",
				"clean up",
				"airports",
				"call sign",
				"chinese char",
				"churches",
				"fish",
				"places",
				"uscounty",
				"township",
				"name",
				"surnames",
				"given names",
				"hospital names",
				"latin name",
				"letter-number",
				"mathematics",
				"ambiguous number",
				"plants",
				"roads",
				"schools",
				"political",
				"genus"
			],
			"suggested": true
		},
		"2": {
			"label": "Second category key",
			"description": "Further category keys, as parameter 1.",
			"type": "string",
			"required": false,
			"suggestedvalues": [
				"split",
				"clean up",
				"airports",
				"call sign",
				"chinese char",
				"churches",
				"fish",
				"places",
				"uscounty",
				"township",
				"name",
				"surnames",
				"given names",
				"hospital names",
				"latin name",
				"letter-number",
				"mathematics",
				"ambiguous number",
				"plants",
				"roads",
				"schools",
				"political",
				"genus"
			]
		},
		"3": {
			"label": "Third category key",
			"description": "Further category keys, as parameter 1.",
			"type": "string",
			"required": false,
			"suggestedvalues": [
				"split",
				"clean up",
				"airports",
				"call sign",
				"chinese char",
				"churches",
				"fish",
				"places",
				"uscounty",
				"township",
				"name",
				"surnames",
				"given names",
				"hospital names",
				"latin name",
				"letter-number",
				"mathematics",
				"ambiguous number",
				"plants",
				"roads",
				"schools",
				"political",
				"genus"
			]
		},
		"4": {
			"label": "Fourth category key",
			"description": "Further category keys, as parameter 1.",
			"type": "string",
			"required": false,
			"suggestedvalues": [
				"split",
				"clean up",
				"airports",
				"call sign",
				"chinese char",
				"churches",
				"fish",
				"places",
				"uscounty",
				"township",
				"name",
				"surnames",
				"given names",
				"hospital names",
				"latin name",
				"letter-number",
				"mathematics",
				"ambiguous number",
				"plants",
				"roads",
				"schools",
				"political",
				"genus"
			]
		},
		"5": {
			"label": "Fifth category key",
			"description": "Further category keys, as parameter 1.",
			"type": "string",
			"required": false,
			"suggestedvalues": [
				"split",
				"clean up",
				"airports",
				"call sign",
				"chinese char",
				"churches",
				"fish",
				"places",
				"uscounty",
				"township",
				"name",
				"surnames",
				"given names",
				"hospital names",
				"latin name",
				"letter-number",
				"mathematics",
				"ambiguous number",
				"plants",
				"roads",
				"schools",
				"political",
				"genus"
			]
		},
		"6": {
			"label": "Sixth category key",
			"description": "Further category keys, as parameter 1.",
			"type": "string",
			"required": false,
			"suggestedvalues": [
				"split",
				"clean up",
				"airports",
				"call sign",
				"chinese char",
				"churches",
				"fish",
				"places",
				"uscounty",
				"township",
				"name",
				"surnames",
				"given names",
				"hospital names",
				"latin name",
				"letter-number",
				"mathematics",
				"ambiguous number",
				"plants",
				"roads",
				"schools",
				"political",
				"genus"
			]
		},
		"7": {
			"label": "Seventh category key",
			"description": "Further category keys, as parameter 1.",
			"type": "string",
			"required": false,
			"suggestedvalues": [
				"split",
				"clean up",
				"airports",
				"call sign",
				"chinese char",
				"churches",
				"fish",
				"places",
				"uscounty",
				"township",
				"name",
				"surnames",
				"given names",
				"hospital names",
				"latin name",
				"letter-number",
				"mathematics",
				"ambiguous number",
				"plants",
				"roads",
				"schools",
				"political",
				"genus"
			]
		},
		"8": {
			"label": "Eighth category key",
			"description": "Further category keys, as parameter 1.",
			"type": "string",
			"required": false,
			"suggestedvalues": [
				"split",
				"clean up",
				"airports",
				"call sign",
				"chinese char",
				"churches",
				"fish",
				"places",
				"uscounty",
				"township",
				"name",
				"surnames",
				"given names",
				"hospital names",
				"latin name",
				"letter-number",
				"mathematics",
				"ambiguous number",
				"plants",
				"roads",
				"schools",
				"political",
				"genus"
			]
		},
		"9": {
			"label": "Ninth category key",
			"description": "Further category keys, as parameter 1.",
			"type": "string",
			"required": false,
			"suggestedvalues": [
				"split",
				"clean up",
				"airports",
				"call sign",
				"chinese char",
				"churches",
				"fish",
				"places",
				"uscounty",
				"township",
				"name",
				"surnames",
				"given names",
				"hospital names",
				"latin name",
				"letter-number",
				"mathematics",
				"ambiguous number",
				"plants",
				"roads",
				"schools",
				"political",
				"genus"
			]
		},
		"10": {
			"label": "Tenth category key",
			"description": "Further category keys, as parameter 1.",
			"type": "string",
			"required": false,
			"suggestedvalues": [
				"split",
				"clean up",
				"airports",
				"call sign",
				"chinese char",
				"churches",
				"fish",
				"places",
				"uscounty",
				"township",
				"name",
				"surnames",
				"given names",
				"hospital names",
				"latin name",
				"letter-number",
				"mathematics",
				"ambiguous number",
				"plants",
				"roads",
				"schools",
				"political",
				"genus"
			]
		},
		"hn": {
			"label": "Human name",
			"description": "Human name disambiguation page with its own sort key.",
			"type": "string",
			"required": false
		},
		"page-title": {
			"label": "page-title",
			"description": "Page title to use, only useful for special cases when default does not work.",
			"type": "string",
			"default": "(FULLPAGENAME)",
			"required": false
		},
		"nocat": {
			"label": "nocat",
			"description": "Set to 'yes' to prevent categorisation.",
			"type": "string",
			"required": false
		},
		"demospace": {
			"label": "demospace",
			"description": "Used for testing.",
			"type": "string",
			"required": false
		},
		"ignore_parentheses": {
			"label": "ignore_parentheses",
			"description": "Set to 'yes' to prevent parentheses in the article title from being parsed as incomplete disambiguation.",
			"type": "string",
			"required": false
		},
		"type": {
			"label": "type",
			"description": "Manually specify the article type in the descriptive text ('This disambiguation page lists {{{type}}} articles...')",
			"type": "string",
			"required": false
		}
	}
}
</templatedata>

== See also ==
* [[Wikipedia:Hatnote]]
* {{tl|Dablinks}}{{snd}}lists wikilinks on the page that link to disambiguation pages
* {{tl|dabsearch}}
* {{tl|Disambiguation needed}} – Adds an inline "disambiguation needed" tag to an ambiguous link within an article, see [[Wikipedia:OTHERUSES]] for more.
* {{tl|WikiProject Disambiguation}} – for disambig talkpages
* {{tl|Redirect}} – for linking to disambiguation pages in an article that is [[WP:PRIMARYREDIRECT|the primary topic of a redirect]]
* {{tl|Other uses}} – for linking to disambiguation pages in articles

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Disambiguation message boxes| ]]

}}</includeonly>