Editing Template:Infobox official post/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{High-use}}
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Check for unknown parameters}}

This template is intended to be used for a variety of official posts. It is not meant only for "political offices" ''per se'', but can also be used for civil service, diplomatic, ecclesiastical, judicial, law enforcement, military and other posts of an official and permanent nature. 

Note that the template is intended to be used on articles about the '''''post''''', rather than the ''person'' holding it for the moment. For the infobox for use on articles about the actual person who is holding the office or held it in the past, see: {{tlx|Infobox officeholder}}.

== Usage ==
{{Parameter names example
| post
| body
| native_name
| insignia
| insigniasize
| insigniacaption
| insigniaalt
| flag
| flagsize
| flagalt
| flagborder
| flagcaption
| image
| imagesize
| alt
| imagecaption
| incumbent
| acting
| incumbentsince
| department
| style
| type
| status
| abbreviation
| member_of
| reports_to
| residence
| seat
| nominator
| appointer
| appointer_qualified
| termlength
| termlength_qualified
| constituting_instrument
| precursor
| superseded_by
| inaugural
| formation
| founder
| named_for
| first
| last
| abolished
| succession
| unofficial_names
| deputy
| salary
| website
| footnotes
}}

All parameters are optional, except for ''post''. It is preferable to have wikilinks to persons, institutions and other items in the template wherever that is possible.

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox official post
| post                    = 
| body                    = 
| native_name             = <!--{{native name||}} -->
| insignia                = 
| insigniasize            = 
| insigniacaption         = 
| insigniaalt             = 
| flag                    = 
| flagsize                = 
| flagalt                 = 
| flagborder              = 
| flagcaption             = 
| image                   = 
| imagesize               = 
| alt                     = 
| imagecaption            = 
| incumbent               = 
| acting                  = 
| incumbentsince          = 
| department              = 
| style                   = 
| type                    = 
| status                  = 
| abbreviation            = 
| member_of               = 
| reports_to              = 
| residence               = 
| seat                    = 
| nominator               = 
| appointer               = 
| appointer_qualified     = 
| termlength              = 
| termlength_qualified    = 
| constituting_instrument = 
| precursor               = 
| inaugural               = 
| formation               = 
| first                   = 
| last                    = 
| abolished               = 
| superseded_by           = 
| succession              = 
| unofficial_names        = 
| deputy                  = 
| salary                  = 
| website                 = <!-- {{url|example.com}}-->
| footnotes               = 
}}
</syntaxhighlight>
{{clear}}

== Parameters ==
<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox official post
| post                    = <!-- Required. No wikilinks here. -->
| body                    = <!-- Optional. -->
| native_name             = <!-- Optional. -->
| insignia                = <!-- An insignia; such as a coat of arms, logo, seal, or other symbol associated with this post, if any. 
                                 Just the image name, no "File:" or "Image:" coding. -->
| insigniasize            = <!-- Example, "150px". 
                                 Default size is 120px. -->
| insigniacaption         = <!-- Short description of the insignia displayed above. -->
| insigniaalt             = <!-- Alt caption. -->
| flag                    = <!-- A flag, positional color, or command sign associated with this post, if any. 
                                 Just the image name, no "File:" or "Image:" coding. -->
| flagsize                = <!-- Example "150px". 
                                 Default size is 120px. -->
| flagborder              = <!-- "yes" to add a border around the flag -->
| flagcaption             = <!-- Short description of the flag etcetera displayed above. -->
| flagalt                 = <!-- Alt caption. -->
| image                   = <!-- Portrait or other image of the current officeholder. 
                                 Just the image name, no "File:" or "Image:" coding. -->
| imagesize               = <!-- Example, "150px" -->
| alt                     = <!-- Alt caption. -->
| imagecaption            = <!-- Optional; will be overwritten if 'incumbent' is used -->
| incumbent               = <!-- Name of the current officeholder -->
| acting = <!-- "y" or "yes" if incumbent is an acting officeholder -->
| incumbentsince = <!-- Date when current officeholder took office -->
| department              = <!-- The organizational entity this official either heads, or is otherwise part of. -->
| style                   = <!-- The recognized manner of address afforded this post. --> 
| type                    = 
| status                  = 
| abbreviation            = <!-- Official abbreviation -->
| member_of               = <!-- Permanent group that the post (not person) is a member of, 
                                 e.g. a cabinet, council, commission, board, junta, politburo etc. -->
| reports_to              = <!-- The immediate superior/supervisor for this post. 
                                 Does not have to be a single one, could be several. -->
| residence               = <!-- Name of official residence, if any. -->
| seat                    = <!-- Location where the office is located. 
                                 If the residence and the workplace are in separate locations, then fill in the workplace here. --> 
| nominator               = <!-- Name of the post/body (not an incumbent person) 
                                 who officially nominates a person to hold this post. -->
| appointer               = <!-- Name of the post/body (not an incumbent person) 
                                 who officially appoints a person to hold this post. -->
| appointer_qualified     = <!-- Space for a qualifying statement. -->
| termlength              = <!-- Optional. -->
| termlength_qualified    = <!-- Space for a qualifying statement. -->
| constituting_instrument = <!-- The official document(s) which provide the formal legal basis for the post. -->
| precursor               = <!-- The immediate predecessor post(s), if any. -->
| inaugural               =
| formation               = <!-- Date when this post was created, or when the first officeholder took office. -->
| first                   = <!-- Name of the person who first held this post. --> 
| last                    = <!-- Optional. -->
| abolished               = <!-- Optional. -->
| succession              = <!-- Optional. -->
| unofficial_names        = <!-- Any unofficial/traditional names this post is known by. -->
| deputy                  = <!-- Name of other post(s) with authority to stand-in for this post. -->
| salary                  = <!-- Official paygrade, or actual amount received. -->
| website                 = <!-- Link to the official website, if any. --> 
| footnotes               =
}}
</syntaxhighlight>
{{clear}}

==TemplateData==
<templatedata>
{
	"params": {
		"post": {
			"label": "Post",
			"description": "Name of the post, do not include links",
			"example": "President",
			"type": "string",
			"required": true,
			"aliases": [
				"name"
			]
		},
		"body": {
			"label": "Body",
			"description": "Name of the body which the post is for",
			"example": "the European Commission",
			"type": "string",
			"suggested": true
		},
		"native_name": {
			"label": "Native name",
			"type": "line",
			"description": "For non-English speaking countries, the native name of the post",
			"example": "{{lang|zh-hans|中华人民共和国主席}}"
		},
		"flag": {
			"label": "Flag image",
			"description": "A flag, positional color, or command sign associated with this post, if any",
			"type": "wiki-file-name"
		},
		"flagsize": {
			"label": "Flag size",
			"example": "150px",
			"description": "Size of the flag",
			"type": "string"
		},
		"flagborder": {
			"label": "Flag border",
			"description": "Set to yes or no",
			"example": "yes",
			"type": "string"
		},
		"flagcaption": {
			"label": "Flag caption",
			"type": "content",
			"description": "A caption for the flag image"
		},
		"insignia": {
			"label": "Insignia image",
			"type": "wiki-file-name",
			"description": "Official insignia of the post",
			"example": "Seal of the United States Department of the Treasury.svg"
		},
		"insigniasize": {
			"label": "Insignia size",
			"example": "150px",
			"description": "Size of the insignia image",
			"type": "string"
		},
		"insigniacaption": {
			"label": "Insignia caption",
			"type": "string",
			"description": "Description of the official insignia of the post",
			"example": "Seal of the Department of the Treasury"
		},
		"image": {
			"label": "Image",
			"type": "wiki-file-name",
			"description": "A picture of the incumbent of this post",
			"example": "Steven Mnuchin official photo (cropped).jpg",
			"suggested": true
		},
		"imagesize": {
			"label": "Image size",
			"example": "150px",
			"description": "Size of the image, in px format",
			"type": "string"
		},
		"alt": {
			"label": "Alt text",
			"description": "Alt text for image",
			"type": "string"
		},
		"imagecaption": {
			"label": "Image caption",
			"description": "Caption for image",
			"type": "string"
		},
		"incumbent": {
			"label": "Incumbent",
			"type": "line",
			"description": "The name of the person who currently holds this role",
			"example": "[[Steven Mnuchin]]",
			"suggested": true
		},
		"acting": {
			"label": "Acting",
			"description": "Set to y or yes if the incumbent is acting",
			"example": "yes",
			"aliases": [
				"Acting"
			]
		},
		"incumbentsince": {
			"label": "Incumbent since",
			"description": "Date incumbent took office",
			"type": "string"
		},
		"type": {
			"label": "Type",
			"type": "string"
		},
		"status": {
			"label": "Status",
			"type": "string"
		},
		"department": {
			"label": "Department",
			"description": "Entity this official heads or is part of",
			"type": "string"
		},
		"style": {
			"label": "Style",
			"description": "Manner of address",
			"example": "Mister Secretary",
			"type": "string"
		},
		"member_of": {
			"label": "Member of",
			"description": "Group that this post is a part of",
			"example": "Cabinet",
			"type": "string",
			"aliases": [
				"memberof"
			]
		},
		"reports_to": {
			"label": "Reports to",
			"description": "Immediate superior of this post",
			"example": "The President",
			"type": "string",
			"aliases": [
				"reportsto"
			]
		},
		"residence": {
			"label": "Residence",
			"description": "Name of official residence",
			"type": "string"
		},
		"seat": {
			"label": "Seat",
			"description": "Location of office",
			"type": "string",
			"example": "[[Washington, D.C.]]"
		},
		"nominator": {
			"label": "Nominator",
			"description": "Name of post or body, not incumbent",
			"type": "string"
		},
		"appointer": {
			"label": "Appointer",
			"description": "Name of the post or body that appoints this position, not the incumbent",
			"type": "string",
			"example": "The [[President of the United States|President]]"
		},
		"appointer_qualified": {
			"label": "Appointer qualification",
			"example": "with [[United States Senate|Senate]] [[advice and consent]]",
			"description": "A qualification message displayed under the name of the appointing office or body",
			"type": "line"
		},
		"termlength": {
			"label": "Term length",
			"type": "string",
			"description": "the length of a term of this official post",
			"example": "4 years"
		},
		"termlength_qualified": {
			"label": "Term length qualification",
			"description": "A qualification message displayed under the length of terms",
			"example": "No restriction on renewal",
			"type": "line"
		},
		"constituting_instrument": {
			"label": "Constituting instrument",
			"description": "The official document(s) which provide the formal legal basis for the post",
			"type": "string"
		},
		"precursor": {
			"label": "Precursor",
			"description": "Immediate precursor post",
			"type": "string"
		},
		"formation": {
			"label": "Date of formation",
			"description": "Date of the creation of the post or the first officeholder taking office",
			"type": "string"
		},
		"first": {
			"label": "First holder",
			"description": "The first person to hold this post",
			"type": "string"
		},
		"last": {
			"label": "Last holder",
			"description": "The last person to hold this post",
			"type": "string"
		},
		"abolished": {
			"label": "Abolished",
			"description": "Date abolished",
			"type": "string"
		},
		"succession": {
			"label": "Succession",
			"type": "string",
			"description": "Rank of succession of this office",
			"example": "[[United States presidential line of succession|Fifth]]<ref>https://www.law.cornell.edu/uscode/text/3/19</ref>"
		},
		"abbreviation": {
			"label": "Official abbreviation",
			"type": "string"
		},
		"unofficial_names": {
			"label": "Unofficial names",
			"type": "string"
		},
		"deputy": {
			"label": "Deputy",
			"type": "string",
			"description": "Wikilink to the office of this position's deputy",
			"example": "[[Vice President of the People's Republic of China|Vice President]]"
		},
		"salary": {
			"label": "Salary",
			"type": "content",
			"description": "The salary of this office",
			"example": "[[Executive Schedule|Executive Schedule, level I]]<ref>{{UnitedStatesCode|5|5312}}</ref>"
		},
		"website": {
			"label": "Website",
			"type": "url"
		},
		"width": {},
		"insigniaalt": {},
		"flagalt": {},
		"inaugural": {},
		"footnotes_title": {},
		"footnotes": {},
		"child": {},
		"embed": {},
		"incumbentlabel": {},
		"superseded_by": {}
	},
	"description": "Infobox for official posts",
	"format": "block"
}
</templatedata>

== Tracking categories ==
* {{clc|Pages using infobox official post with footnotes title}}
{{Infobox tracking categories}}

== See also ==

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Politics and government infobox templates|Official Post]]
[[Category:Templates that add a tracking category]]

}}</includeonly>