View source for 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}}

== Examples ==
=== Example 1===
{{Infobox official post
| post                    = President
| body                    = the<br />European Commission
| flag                    = Flag of Europe.svg
| flagsize                = 100px
| flagcaption             = [[Flag of Europe|Commission emblem (EU flag)]]
| flagalt                 = Flag of the European Union
| image                   = José Manuel Barroso MEDEF.jpg
| alt                     = José Manuel Barroso
| incumbent               = [[José Manuel Barroso]]
| incumbentsince          = 23 November 2004
| member_of               = [[European Commission]]
| seat                    = [[Berlaymont building]], [[Brussels]], [[Belgium]]
| nominator               = [[European Council]]<br />on the basis of the latest [[Elections in the European Union|European elections]]
| appointer               = [[European Parliament]]
| termlength              = Five years
| constituting_instrument = [[Treaties of the European Union]]
| formation               = 1 January 1958
| inaugural               = [[Walter Hallstein]]
| deputy                  = [[Vice-President of the European Commission]]
| salary                  = €24,422.80 per month
| website                 = [https://ec.europa.eu/archives/commission_2010-2014/president/index_en.htm ec.europa.eu/president]
}}

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox official post
| post                    = President
| body                    = the<br />European Commission
| flag                    = Flag of Europe.svg
| flagsize                = 100px
| flagcaption             = [[Flag of Europe|Commission emblem (EU flag)]]
| flagalt                 = Flag of the European Union
| image                   = José Manuel Barroso MEDEF.jpg
| alt                     = José Manuel Barroso
| incumbent               = [[José Manuel Barroso]]
| incumbentsince          = 23 November 2004
| member_of               = [[European Commission]]
| seat                    = [[Berlaymont building]], [[Brussels]], [[Belgium]]
| nominator               = [[European Council]]<br />on the basis of the latest [[Elections in the European Union|European elections]]
| appointer               = [[European Parliament]]
| termlength              = Five years
| constituting_instrument = [[Treaties of the European Union]]
| formation               = 1 January 1958
| inaugural               = [[Walter Hallstein]]
| deputy                  = [[Vice-President of the European Commission]]
| salary                  = €24,422.80 per month
| website                 = [https://ec.europa.eu/archives/commission_2010-2014/president/index_en.htm ec.europa.eu/president]
}}
</syntaxhighlight>
{{clear}}

=== Example 2 ===
{{Infobox official post
| post                     = Secretary of Defense of the United States of America
| flag                     = Flag of the United States Secretary of Defense.svg
| flagsize                 = 120px
| flagcaption              = Flag of the Secretary of Defense
| flagalt                  = Secretary of Defense official flag
| insignia                 = US Department of Defense seal.svg
| insigniasize             = 110px
| insigniacaption          = Seal of the Department of Defense
| insigniaalt              = Department of Defense official seal
| incumbentsince           = {{start date|2013|02|27}}
| image                    = Chuck Hagel Defense portrait.jpg
| alt                      = Chuck Hagel, Secretary of Defense
| incumbent                = [[Chuck Hagel]]
| style                    = ''Mister Secretary''
| member_of                = {{ubl|[[United States Cabinet|Cabinet]]|[[United States National Security Council|National Security Council]]}}
| department               = {{ubl|[[United States Department of Defense|Department of Defense]]|[[Office of the Secretary of Defense|OSD]]}}
| reports_to               = The [[President of the United States|President]]
| seat                     = [[The Pentagon]], [[Arlington County, Virginia|Arlington County]], [[Virginia]]
| appointer                = The [[President of the United States|President]]
| appointer_qualified      = with [[United States Senate|Senate]] [[advice and consent]]
| termlength               = No fixed term
| constituting_instrument  = {{ubl|{{UnitedStatesCode|10|113}}|{{UnitedStatesCode|50|401}}}}
| precursor                = {{ubl|[[United States Secretary of War|Secretary of War]]|and [[United States Secretary of the Navy|Secretary of the Navy]]}}
| formation                = September 19, 1947
| inaugural                = [[James Forrestal]]
| succession               = Sixth<br/>in the [[United States presidential line of succession|presidential line of succession]]
| deputy                   = [[United States Deputy Secretary of Defense|Deputy Secretary of Defense]]<br/>(principal deputy<br/>[[Chairman of the Joint Chiefs of Staff]]<br/>(military deputy)
| salary                   = [[Executive Schedule|Executive Schedule, level 1]]
| website                  = {{URL|https://www.defense.gov/}}
}}

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox official post
| post                     = Secretary of Defense of the United States of America
| flag                     = Flag of the United States Secretary of Defense.svg
| flagsize                 = 120px
| flagcaption              = Flag of the Secretary of Defense
| flagalt                  = Secretary of Defense official flag
| insignia                 = United States Department of Defense Seal.svg
| insigniasize             = 110px
| insigniacaption          = Seal of the Department of Defense
| insigniaalt              = Department of Defense official seal
| incumbentsince           = {{start date|2013|02|27}}
| image                    = Chuck Hagel Defense portrait.jpg
| alt                      = Chuck Hagel, Secretary of Defense
| incumbent                = [[Chuck Hagel]]
| style                    = ''Mister Secretary''
| member_of                = {{ubl|[[United States Cabinet|Cabinet]]|[[United States National Security Council|National Security Council]]}}
| department               = {{ubl|[[United States Department of Defense|Department of Defense]]|[[Office of the Secretary of Defense|OSD]]}}
| reports_to               = The [[President of the United States|President]]
| seat                     = [[The Pentagon]], [[Arlington County, Virginia|Arlington County]], [[Virginia]]
| appointer                = The [[President of the United States|President]]
| appointer_qualified      = with [[United States Senate|Senate]] [[advice and consent]]
| termlength               = No fixed term
| constituting_instrument  = {{ubl|{{UnitedStatesCode|10|113}}|{{UnitedStatesCode|50|401}}}}
| precursor                = {{ubl|[[United States Secretary of War|Secretary of War]]|and [[United States Secretary of the Navy|Secretary of the Navy]]}}
| formation                = September 19, 1947
| inaugural                = [[James Forrestal]]
| succession               = Sixth<br/>in the [[United States presidential line of succession|presidential line of succession]]
| deputy                   = [[United States Deputy Secretary of Defense|Deputy Secretary of Defense]]<br/>(principal deputy)<br/>[[Chairman of the Joint Chiefs of Staff]]<br/>(military deputy)
| salary                   = [[Executive Schedule|Executive Schedule, level 1]]
| website                  = {{URL|https://www.defense.gov/}}
}}
</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": {}
	},
	"description": "Infobox for official posts",
	"format": "block"
}
</templatedata>

== Tracking category ==
* {{clc|Pages using infobox official post with footnotes title}}

== See also ==
{{Organization infoboxes}}

<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>