View source for Template:Infobox U.R. state/doc

{{Documentation subpage}}
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Coordinates|Module:Check for unknown parameters|Module:Settlement short description}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Uses Infobox settlement}}
{{Generic template demo |official_name |name |image_flag |flag_alt |image_seal |seal_alt |nickname |motto |anthem  |image_map |map_alt |OfficialLang |Languages |population_demonym |seat |LargestCity |LargestCounty| LargestMetro |area_rank |area_total_sq_mi |area_total_km2 | area_water_percent |width_mi |width_km |length_mi |length_km |Latitude |Longitude |population_rank |2010Pop |population_as_of |2010DensityUS |2010Density |population_density_rank |MedianHouseholdIncome |IncomeRank | elevation_m | elevation_ft| elevation_max_m| elevation_max_ft| elevation_max_point| elevation_min_m | elevation_min_ft | elevation_min_point  |Former=Territory |AdmittanceDate |AdmittanceOrder |Governor |Lieutenant Governor |Lieutenant Governor_alt  |Legislature |Upperhouse |Lowerhouse |Senators |Representative | timezone1 | utc_offset1 | timezone1_DST | utc_offset1_DST | timezone1_location | timezone2 | utc_offset2 | timezone2_DST | utc_offset2_DST | timezone2_location |iso_code |postal_code |TradAbbreviation |website |footnotes
}}

== Usage ==
<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox U.S. state
| official_name       = 
| name               = 
| image_flag          = 
| flag_alt            = 
| image_seal         = 
| seal_alt           = 
| nickname           = 
| motto              = 
| anthem             =            
| image_map          = 
| map_alt            = 
| seat               = 
| LargestCity        = <!-- Set this to "capital" if the capital and the largest city are the same. --> 
| LargestMetro       = 
| LargestCounty      = 
| area_rank          = 
| area_total_sq_mi   = 
| area_total_km2     = 
| area_water_percent =
| elevation_m        = 
| elevation_ft       = 
| elevation_max_m    = 
| elevation_max_ft   = 
| elevation_max_point=
| elevation_min_m    = 
| elevation_min_ft   = 
| elevation_min_point= 
| length_km          = 
| length_mi          = 
| width_km           = 
| width_mi           = 
| Latitude           = 
| Longitude          = 
| population_rank    =
| population_demonym = 
| OfficialLang        = 
| Languages          = 
| 2010Pop            = 
| population_as_of   = 
| 2010DensityUS      = 
| 2010Density        = 
| DensityRank        = 
| MedianHouseholdIncome = 
| IncomeRank         =
| Former             =
| AdmittanceDate     = 
| AdmittanceOrder    = 
| Governor           = 
| Lieutenant Governor =
| Lieutenant Governor_alt = <!-- OPTIONAL. For states w/o Lieutenant Governor, the title of the next in line of succession -->
| Legislature        = 
| Upperchamber       = 
| Lowerchamber       = 
| Senators           = 
| Representative     = 
| timezone1          = 
| utc_offset1        = 
| timezone1_DST      = 
| utc_offset1_DST    = 
| timezone1_location = 
| timezone2          = 
| utc_offset2        = 
| timezone2_DST      = 
| utc_offset2_DST    = 
| timezone2_location = 
| iso_code           =
| postal_code        =
| TradAbbreviation   =
| website            = <!-- OPTIONAL. Do NOT include http:// or trailing / Ex: www.example.com NOT http://www.example.com/ -->
| module             =
| footnotes          = 
}}
</syntaxhighlight>

==Parameters==
The parameters below are required unless marked as ''optional''.

===Name===
*'''name''': the common name of the state
*'''official_name''': the full name of the state (such as "State of California" or "Commonwealth of Pennsylvania")
*'''nickname''': one or more nicknames for the state, usually separated by semicolons

===Flag===
*'''image_flag''': file name of the state flag image; example: {{para|Flag|Flag of California.svg}}
** A small border is drawn around the flag unless {{para|flag_border|no}} is set (for e.g. {{para|Name|Ohio}}, which is the only state with a non-rectangular flag).
*'''flag_alt''': (''optional'') [[WP:ALT|alt-text]] for the flag image; if unspecified, the alt-text defaults to "Flag of <var>Name</var>"
*'''flag_link''': (''optional'') a link to an article about the state's flag; if unspecified, the link defaults to "<nowiki>[[</nowiki>Flag of <var>Name</var>|Flag<nowiki>]]</nowiki>"

===Seal===
*'''image_seal''': file name of the state seal image; example: {{para|Seal|Seal of California.svg}}
*'''seal_alt''': (''optional'') [[WP:ALT|alt-text]] for the seal image; if unspecified, the alt-text defaults to "State seal of <var>Name</var>"
*'''seal_link''': (''optional'') a link to an article about the state's seal; if unspecified, the link defaults to "<nowiki>[[</nowiki>Seal of <var>Name</var>|Seal<nowiki>]]</nowiki>"

===Motto===
*'''motto''': (''optional'') state motto

===Song===
*'''anthem''': (''optional'') state song or anthem

===Map===
*'''Map''': file name of a map highlighting the state; example: {{para|Map|California in United States.svg}}
*'''MapAlt''': (''optional'') [[WP:ALT|alt-text]] for the map image; if unspecified, the alt-text defaults to "Map of the United States with <var>Name</var> highlighted"

===Languages===
*'''OfficialLang''': (''optional'') the state's official language(s)
*'''Languages''': (''optional'') language(s) with a significant number of speakers in the state; often listed with a percentage, such as "English 94.6%, Spanish 5.9%"

===Demonym===
*'''population_demonym''': (''optional'') the name for residents of the state; in some cases editors have linked these terms to [[List of demonyms for U.S. states]]

===Cities and county ===
*'''seat''': the state's capital city
*'''LargestCity''': the largest city (by population) in the state
** Specify {{para|LargestCity|capital}} if the capital is also the largest city
*'''LargestMetro''': (''optional'') the largest [[statistical area (United States)|metropolitan area]] and [[List of United States urban areas|urban areas]] (by population) in the state
*'''LargestCounty''': (''optional'') the largest [[List of the most populous counties by U.S. state|county]] or county equivalent (by population).

===Area===
*'''AreaRank''': where the state ranks on [[List of U.S. states and territories by area]]; example: {{para|AreaRank|5th}}
*'''TotalAreaUS''': land + water area in square miles (usually rounded to a whole number)
*'''TotalArea''': land + water area in square kilometers (usually rounded to a whole number)
*'''width_mi''': width of the state in miles (usually rounded to a whole number or approximated to the tens place, such as "360")
*'''width_km''': width of the state in kilometers (usually rounded to a whole number or approximated to the tens place, such as "580")
*'''length_mi''': length of the state in miles (usually rounded to a whole number or approximated to the tens place, such as "360")
*'''length_km''': length of the state in kilometers (usually rounded to a whole number or approximated to the tens place, such as "580")
*'''area_water_percent''': percent of total area that is water; example: {{para|area_water_percent|3.2}}
*'''Latitude''': range of latitudes in the state, usually given in degrees and minutes from the southernmost to the northernmost parallel
:example: {{para|Latitude|25° 50′ N to 36° 30′ N}}
*'''Longitude''': range of longitudes in the state, usually given in degrees and minutes from the easternmost to the westernmost meridian
:example: {{para|Longitude|93° 31′ W to 106° 39′ W}}

===Population===
*'''PopRank''': where the state ranks on [[List of U.S. states and territories by population]]; example: {{para|PopRank|25th}}
*'''2020Pop''': the most recent U.S. Census population for the state; most states list the most-recent population estimate
*'''population_as_of''': The year for the population
*'''2020DensityUS''': most recent population ÷ land area in square miles
*'''2020Density''': most recent population ÷ land area in square km
*'''DensityRank''': where the state ranks on [[List of U.S. states by population density]]; example: {{para|DensityRank|33rd}}
*'''MedianHouseholdIncome''': (''optional'') see [[Household income in the United States#Income by state]]
*'''IncomeRank''': where the state ranks on [[Household income in the United States#Income by state]]<!--
old population metrics
-->
*'''2000Pop'''/'''2010Pop''': 2000/2010 population for the state
** Overridden by ''2020Pop''.
*'''2000DensityUS'''/'''2010DensityUS''': 2000/2010 population ÷ land area in square miles
** Overridden by ''2020DensityUS''.
*'''2000Density'''/'''2010Density''': 2000/2010 population ÷ land area in square km
** Overridden by ''2020Density''.

===Elevations===
*'''elevation_max_point''': text naming the location of the highest point in the state; usually it's the name of a mountain or hill
*'''elevation_max_ft''': elevation of the highest point in feet
*'''elevation_max_m''': elevation of the highest point in meters
*'''elevation_ft''': mean elevation of the state in feet
*'''elevation_m''': mean elevation of the state in meters
*'''elevation_min_point''': (''optional'') text naming the location of the lowest point in the state; usually it's the name of a body of water
*'''elevation_min_ft''': elevation of the lowest point in feet
*'''elevation_min_m''': elevation of the lowest point in meters

===History===
*'''Former''': (''optional'') the article name for the place before it became a state; example (for Oregon): {{para|Former|Oregon Territory}}
*'''AdmittanceDate''': the date the state joined the U.S.
*'''AdmittanceOrder''': the rank among [[List of U.S. states by date of admission to the Union]]

===Government===
*'''Governor''': the name and party of the current governor
*'''Lieutenant Governor''': the name and party of the current Lt. Governor/next-in-succession
*'''Lieutenant Governor_alt''': (''optional'', defaults to "Lieutenant Governor") the name of the title that succeeds the Governor; several states have no Lt. Gov. and instead their Secretary of State or President of the Senate is next in succession
*'''Legislature''': a link to the article about the state's legislature; example: {{para|Legislature|<nowiki>[[New Mexico Legislature]]</nowiki>}}
*'''Upperchamber''': a link to the article about the state's upper legislative chamber; example: {{para|Upperchamber|<nowiki>[[Wisconsin State Senate|Senate]]</nowiki>}}
*'''Lowerchamber''': a link to the article about the state's lower legislative chamber; example: {{para|Lowerchamber|<nowiki>[[Wisconsin State Assembly|State Assembly]]</nowiki>}}
*'''Senators''': the two U.S. Senators from the state, listed by name and party; the two are separated by a linebreak <nowiki><br /></nowiki>
*'''Representative''': (''optional'') text that appears before the link to the list of delegates to the House of Representatives
:Most states tally the number of Representatives per party (example: {{para|Representative|6 Democrats, 6 Republicans}}). States with only a few  Representatives usually list the people by name.

===Time zones===
If ''timezone2'' is specified, the time zone section will consist of four rows and the location for timezone1 and timezone2 should be specified.

===Other information===
*'''ISOCode''': (''optional'') the [[ISO 3166-2:US]] code for the state
*'''postal_code''': (''optional'') the state's current standard two-letter [[List of U.S. state abbreviations#Postal codes|postal abbreviation]]
*'''TradAbbreviation''': (''optional'') common traditional abbreviations for the state
*'''website''': (''optional'') an official URL for the state
*'''module''': (''optional'') used to insert other infobox
*'''footnotes''': (''optional'') where footnotes can be placed

==Maintenance categories ==
* {{clc|Pages using infobox U.S. state with unknown parameters}}

== Microformat ==
{{UF-hcard-place}}

==TemplateData==
{{Templatedata header}}
<templatedata>
{
	"params": {
		"Seallink": {
			"label": "Link to seal's page",
			"description": "Link to the Wikipedia page of the state's seal",
			"type": "date"
		},
		"OfficialLang": {
			"label": "Official language",
			"description": "The state's official language, if it has one",
			"example": "[[Template:Official languages of U.S. states and territories|English]]",
			"type": "content"
		},
		"Languages": {
			"label": "Languages spoken",
			"example": "Language spoken at home<ref name=\"StatisticalAtlas\">{{cite web |url= https://statisticalatlas.com/state/California/Languages|title=Languages in California (State)|work=Statistical Atlas|access-date=August 15, 2018|archive-url= https://web.archive.org/web/20180815233304/https://statisticalatlas.com/state/California/Languages|archive-date=August 15, 2018|url-status=live}}</ref> * [[English language|English]]: 58.1% * [[Spanish language|Spanish]]: 28.8% * [[Chinese language|Chinese]]: 3.0% * [[Filipino language|Filipino]]: 2.2% * Other: 7.9%",
			"type": "content"
		},
		"LargestCity": {
			"label": "Largest city",
			"description": "The state's largest city by population",
			"example": "Los Angeles",
			"type": "wiki-page-name",
			"suggested": true
		},
		"Capital": {
			"description": "The state's capital city",
			"example": "Sacramento",
			"type": "wiki-page-name",
			"required": true
		},
		"LargestMetro": {
			"label": "Largest metropolitan area",
			"description": "The state's largest metropolitan area and urban area by population",
			"example": "[[Greater Los Angeles]]",
			"type": "string",
			"suggested": true
		},
		"LargestCounty": {
			"label": "Largest county",
			"description": "The state's largest county or county equivalent (by population)",
			"example": "[[Los Angeles County, California]]",
			"type": "string",
			"suggested": true
		},
		"TotalAreaUS": {},
		"WidthUS": {},
		"Width": {},
		"LengthUS": {},
		"Length": {},
		"PCWater": {},
		"Latitude": {},
		"Longitude": {},
		"PopRank": {
			"aliases": [
				"population_rank"
			],
			"label": "Population rank",
			"example": "1st",
			"type": "string"
		},
		"2010Pop": {},
		"population_as_of": {},
		"2000Pop": {},
		"MedianHouseholdIncome": {
			"label": "Median household income",
			"example": "$71,805 (2017)<ref>{{cite web |url= http://kff.org/other/state-indicator/median-annual-income/?currentTimeframe=0 |website=The Henry J. Kaiser Family Foundation |title=Median Annual Household Income |access-date=May 19, 2018}}</ref>",
			"type": "content"
		},
		"2010DensityUS": {},
		"2000DensityUS": {},
		"2010Density": {},
		"2000Density": {},
		"DensityRank": {},
		"IncomeRank": {},
		"HighestPoint": {},
		"HighestElevUS": {},
		"HighestElev": {},
		"MeanElevUS": {},
		"MeanElev": {},
		"LowestPoint": {},
		"LowestElev": {},
		"LowestElevUS": {},
		"Former": {
			"label": "Former name",
			"description": "The state's former name(s)",
			"example": "[[California Republic]]",
			"type": "string"
		},
		"AdmittanceDate": {
			"label": "Admittance date",
			"description": "Date the state was admitted to the union",
			"type": "date"
		},
		"AdmittanceOrder": {
			"label": "Admittance order",
			"type": "string"
		},
		"Governor": {
			"example": "{{nowrap|[[Gavin Newsom]] ([[Democratic Party (United States)|D]])}}",
			"type": "content"
		},
		"Lieutenant Governor_alt": {
			"label": "Lieutenant Governor alt title",
			"type": "string"
		},
		"Lieutenant Governor": {
			"example": "{{nowrap|[[Eleni Kounalakis]] (D)}}",
			"type": "content",
			"suggested": true
		},
		"Senate Pro Tem": {},
		"House Speaker": {},
		"Legislature": {},
		"Upperchamber": {
			"aliases": [
				"Upperhouse"
			],
			"label": "Upper chamber",
			"description": "The state's upper legislative chamber",
			"example": "[[California State Senate|State Senate]]",
			"type": "content",
			"suggested": true
		},
		"Lowerchamber": {
			"aliases": [
				"Lowerhouse"
			],
			"label": "Lower chamber",
			"description": "The state's lower legislative chamber",
			"example": "[[California State Assembly|State Assembly]]",
			"type": "content",
			"suggested": true
		},
		"Senators": {
			"description": "The state's Senators in the US Senate",
			"example": "{{ublist|[[Dianne Feinstein]] (D)|[[Kamala Harris]] (D)}}",
			"type": "content",
			"required": true
		},
		"Representatives": {
			"description": "The state's number of representatives in the House of Representatives by political party",
			"example": "{{ublist|46 Democrats|7 Republicans}}",
			"type": "content",
			"required": true
		},
		"timezone1": {},
		"utc_offset1": {},
		"timezone1_DST": {},
		"utc_offset1_DST": {},
		"timezone1_location": {},
		"timezone2": {},
		"utc_offset2": {},
		"timezone2_DST": {},
		"utc_offset2_DST": {},
		"timezone2_location": {},
		"PostalAbbreviation": {
			"label": "Postal abbreviation",
			"description": "Official 2-letter abbreviation of the state",
			"example": "CA",
			"type": "string"
		},
		"TradAbbreviation": {
			"label": "Traditional abbreviation(s)",
			"description": "The state's traditional abbreviation(s)",
			"example": "Calif., Cal.",
			"type": "string"
		},
		"official_name": {
			"label": "Official name",
			"example": "Commonwealth of Virginia",
			"type": "string",
			"description": "The state's official name. Use only when not of the form 'State of X'"
		},
		"area_code": {
			"label": "Area codes",
			"description": "A list of the state's telephone area codes",
			"example": "209 213 310 323 408 415 510 530 559 562 619 626 650 661 707 714 760 805 818 831 858 909 916 925 949",
			"type": "string"
		},
		"iso_code": {
			"label": "ISO code",
			"example": "US-CA",
			"type": "string"
		},
		"website": {
			"label": "Official website",
			"description": "The state's official website",
			"example": "https://www.ca.gov/",
			"type": "url"
		},
		"seal_alt": {
			"label": "Seal alternate text",
			"type": "string"
		},
		"flag_link": {
			"label": "Link to flag's page",
			"description": "Link to the Wikipedia page of the state's flag",
			"example": "Flag of California",
			"type": "wiki-page-name"
		},
		"image_seal": {
			"label": "Seal image",
			"description": "An image of the state's seal",
			"type": "wiki-file-name"
		},
		"name": {
			"label": "Name",
			"description": "The state's name",
			"example": "California",
			"type": "string"
		},
		"image_flag": {
			"label": "Flag image",
			"description": "An image of the state's flag",
			"example": "Flag of California.svg",
			"type": "wiki-file-name"
		},
		"flag_alt": {
			"label": "Flag alternate text",
			"type": "string"
		},
		"nickname": {
			"label": "State nickname",
			"description": "The state's nickname",
			"example": "The Golden State",
			"type": "string"
		},
		"nicknames": {
			"label": "State nicknames",
			"description": "The state's nicknames, if there are more than one",
			"example": "The Constitution State (official), The Nutmeg State",
			"type": "content"
		},
		"footnotes": {
			"label": "Footnotes",
			"type": "content"
		},
		"map_alt": {
			"label": "Map alternate text",
			"type": "string"
		},
		"image_map": {
			"label": "Map image",
			"example": "California in United States.svg",
			"type": "wiki-file-name"
		},
		"anthem": {
			"label": "State anthem",
			"description": "The state's anthem",
			"example": "\"[[I Love You, California]]\"<br />[[File:\"I Love You, California\" - Regional anthem of California.ogg|center]]",
			"type": "content"
		},
		"motto": {
			"label": "State motto",
			"description": "The state's motto(s)",
			"example": "\"[[Eureka (word)|Eureka]]\"<ref name=\"motto-symbols\">{{cite web |url= http://leginfo.legislature.ca.gov/faces/codes_displayText.xhtml?lawCode=GOV&division=2.&title=1.&part=&chapter=2.&article=|title=Chapter 2 of Division 2 of Title 1 of the California Government Code|work=[[California Office of Legislative Counsel]]|access-date=February 23, 2019 }}</ref>",
			"type": "content"
		},
		"population_demonym": {
			"label": "Demonym",
			"description": "What the state's residents are called",
			"example": "Californian",
			"type": "string",
			"suggested": true
		},
		"area_rank": {
			"label": "Area rank",
			"example": "3rd",
			"type": "string"
		},
		"total_area": {
			"label": "Total area",
			"type": "number"
		},
		"module": {
			"label": "Module",
			"type": "string"
		}
	},
	"format": "block",
	"description": "An infobox for States of the United States of America."
}
</templatedata>
<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:United Republic of Aurelia subdivision infobox templates|State]]
[[Category:United Republic of Aurelia templates}}
}}</includeonly>