Template:Infobox U.S. state

{{{name}}}
{{{name}}}
State
	{{{official_name}}}
	[[File:{{{image_flag}}}\|125px\|alt={{{flag_alt}}}\|border\|Flag of {{{name}}}]] [[Flag of {{{name}}}\|Flag]] [[File:{{{image_seal}}}\|100x100px\|alt={{{seal_alt}}}\|Official seal of {{{name}}}]] [[Seal of {{{name}}}\|Seal]]
	Nickname: {{{nickname}}}
	Motto: {{{motto}}}
	Anthem: {{{anthem}}}
	[[File:{{{image_map}}}\|300px\|alt={{{map_alt}}}\|Map of the United States with {{{name}}} highlighted]] Map of the United States with {{{name}}} highlighted
Country	United States
Before statehood	Territory
Admitted to the Union	{{{AdmittanceDate}}} ({{{AdmittanceOrder}}})
Capital	{{{seat}}}
Largest city	{{{LargestCity}}}
Largest county or equivalent	{{{LargestCounty}}}
Largest metro and urban areas	{{{LargestMetro}}}
Government
• [[Governor of {{{name}}}\|Governor]]	{{{Governor}}}
• [[Lieutenant Governor of {{{name}}}\|{{{Lieutenant Governor_alt}}}]]	{{{Lieutenant Governor}}}
Legislature	{{{Legislature}}}
• Upper house	{{{Upperhouse}}}
• Lower house	{{{Lowerhouse}}}
[[List of United States senators from {{{name}}}\|U.S. senators]]	{{{Senators}}}
[[List of United States representatives from {{{name}}}\|U.S. House delegation]]	{{{Representative}}} ([[United States congressional delegations from {{{name}}}\|list]])
Area
• Total	{{{area_total_sq_mi}}} sq mi ({{{area_total_km2}}} km2)
• Rank	{{{area_rank}}}
Dimensions
• Length	{{{length_mi}}} mi ({{{length_km}}} km)
• Width	{{{width_mi}}} mi ({{{width_km}}} km)
Elevation	{{{elevation_ft}}} ft ({{{elevation_m}}} m)
Highest elevation ({{{elevation_max_point}}})	{{{elevation_max_ft}}} ft ({{{elevation_max_m}}} m)
Lowest elevation ({{{elevation_min_point}}})	{{{elevation_min_ft}}} ft ({{{elevation_min_m}}} m)
Population ({{{population_as_of}}})
• Total	{{{2,010Pop}}}
• Rank	{{{population_rank}}}
• Rank	{{{population_density_rank}}}
• Median household income	{{{MedianHouseholdIncome}}}
• Income rank	{{{IncomeRank}}}
Demonym	{{{population_demonym}}}
Language
• Official language	{{{OfficialLang}}}
• Spoken language	{{{Languages}}}
Time zones
{{{timezone1_location}}}	[[UTC{{{utc_offset1}}}]] ({{{timezone1}}})
• Summer (DST)	[[UTC{{{utc_offset1_DST}}}]] ({{{timezone1_DST}}})
{{{timezone2_location}}}	[[UTC{{{utc_offset2}}}]] ({{{timezone2}}})
• Summer (DST)	[[UTC{{{utc_offset2_DST}}}]] ({{{timezone2_DST}}})
USPS abbreviation	{{{postal_code}}}
ISO 3166 code	{{{iso_code}}}
Traditional abbreviation	{{{TradAbbreviation}}}
Latitude	{{{Latitude}}}
Longitude	{{{Longitude}}}
Website	{{{website}}}
	{{{footnotes}}}

Template documentation[view] [edit] [history] [purge]

This template uses Lua:

This template is a customized wrapper for {{Infobox settlement}} and as such included in Category:Templates calling Infobox settlement. Any field from {{Infobox settlement}} can work so long as it is added to this template first. It will also emit the same hCard and Geo microformats as {{Infobox settlement}}. Questions? Just ask here or over at Template talk:Infobox settlement.

Usage

{{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          = 
}}

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: |Flag=Flag of California.svg
- A small border is drawn around the flag unless |flag_border=no is set (for e.g. |Name=Ohio, which is the only state with a non-rectangular flag).
flag_alt: (optional) alt-text for the flag image; if unspecified, the alt-text defaults to "Flag of Name"
flag_link: (optional) a link to an article about the state's flag; if unspecified, the link defaults to "[[Flag of Name|Flag]]"

Seal

image_seal: file name of the state seal image; example: |Seal=Seal of California.svg
seal_alt: (optional) alt-text for the seal image; if unspecified, the alt-text defaults to "State seal of Name"
seal_link: (optional) a link to an article about the state's seal; if unspecified, the link defaults to "[[Seal of Name|Seal]]"

Motto

motto: (optional) state motto

Song

anthem: (optional) state song or anthem

Map

Map: file name of a map highlighting the state; example: |Map=California in United States.svg
MapAlt: (optional) alt-text for the map image; if unspecified, the alt-text defaults to "Map of the United States with Name 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 |LargestCity=capital if the capital is also the largest city
LargestMetro: (optional) the largest metropolitan area and urban areas (by population) in the state
LargestCounty: (optional) the largest county or county equivalent (by population).

Area

AreaRank: where the state ranks on List of U.S. states and territories by area; example: |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: |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: |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: |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: |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: |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
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): |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: |Legislature=[[New Mexico Legislature]]
Upperchamber: a link to the article about the state's upper legislative chamber; example: |Upperchamber=[[Wisconsin State Senate|Senate]]
Lowerchamber: a link to the article about the state's lower legislative chamber; example: |Lowerchamber=[[Wisconsin State Assembly|State Assembly]]
Senators: the two U.S. Senators from the state, listed by name and party; the two are separated by a linebreak <br />
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: |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 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

Category:Pages using infobox U.S. state with unknown parameters (24)

Microformat

The HTML mark up produced by this template includes an hCard microformat, which makes the place-name and location parsable by computers, either acting automatically to catalogue article across Wikipedia, or via a browser tool operated by a person, to (for example) add the subject to an address book. For more information about the use of microformats on Wikipedia, please see the microformat project.

If the place or venue has an "established", "founded", "opened" or similar date that is specific to the day, use {{start date}} unless the date is before 1583 CE. If it has a URL, use {{URL}}.

hCard uses HTML classes including:

adr
category
country-name
extended-address
fn
label
locality
nickname
note
org
street-address
url
vcard

Please do not rename or remove these classes nor collapse nested elements which use them.

TemplateData

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

TemplateData for Infobox U.S. state

An infobox for States of the United States of America.

Template parameters[Edit template data]
This template prefers block formatting of parameters.
Parameter		Description	Type	Status
Link to seal's page	`Seallink`	Link to the Wikipedia page of the state's seal	Date	optional
Official language	`OfficialLang`	The state's official language, if it has one Example [[Template:Official languages of U.S. states and territories\|English]]	Content	optional
Languages spoken	`Languages`	no description 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%	Content	optional
Largest city	`LargestCity`	The state's largest city by population Example Los Angeles	Page name	suggested
Capital	`Capital`	The state's capital city Example Sacramento	Page name	required
Largest metropolitan area	`LargestMetro`	The state's largest metropolitan area and urban area by population Example [[Greater Los Angeles]]	String	suggested
Largest county	`LargestCounty`	The state's largest county or county equivalent (by population) Example [[Los Angeles County, California]]	String	suggested
TotalAreaUS	`TotalAreaUS`	no description	Unknown	optional
WidthUS	`WidthUS`	no description	Unknown	optional
Width	`Width`	no description	Unknown	optional
LengthUS	`LengthUS`	no description	Unknown	optional
Length	`Length`	no description	Unknown	optional
PCWater	`PCWater`	no description	Unknown	optional
Latitude	`Latitude`	no description	Unknown	optional
Longitude	`Longitude`	no description	Unknown	optional
Population rank	`PopRank` `population_rank`	no description Example 1st	String	optional
2010Pop	`2010Pop`	no description	Unknown	optional
population_as_of	`population_as_of`	no description	Unknown	optional
2000Pop	`2000Pop`	no description	Unknown	optional
Median household income	`MedianHouseholdIncome`	no description 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>	Content	optional
2010DensityUS	`2010DensityUS`	no description	Unknown	optional
2000DensityUS	`2000DensityUS`	no description	Unknown	optional
2010Density	`2010Density`	no description	Unknown	optional
2000Density	`2000Density`	no description	Unknown	optional
DensityRank	`DensityRank`	no description	Unknown	optional
IncomeRank	`IncomeRank`	no description	Unknown	optional
HighestPoint	`HighestPoint`	no description	Unknown	optional
HighestElevUS	`HighestElevUS`	no description	Unknown	optional
HighestElev	`HighestElev`	no description	Unknown	optional
MeanElevUS	`MeanElevUS`	no description	Unknown	optional
MeanElev	`MeanElev`	no description	Unknown	optional
LowestPoint	`LowestPoint`	no description	Unknown	optional
LowestElev	`LowestElev`	no description	Unknown	optional
LowestElevUS	`LowestElevUS`	no description	Unknown	optional
Former name	`Former`	The state's former name(s) Example [[California Republic]]	String	optional
Admittance date	`AdmittanceDate`	Date the state was admitted to the union	Date	optional
Admittance order	`AdmittanceOrder`	no description	String	optional
Governor	`Governor`	no description Example {{nowrap\|[[Gavin Newsom]] ([[Democratic Party (United States)\|D]])}}	Content	optional
Lieutenant Governor alt title	`Lieutenant Governor_alt`	no description	String	optional
Lieutenant Governor	`Lieutenant Governor`	no description Example {{nowrap\|[[Eleni Kounalakis]] (D)}}	Content	suggested
Senate Pro Tem	`Senate Pro Tem`	no description	Unknown	optional
House Speaker	`House Speaker`	no description	Unknown	optional
Legislature	`Legislature`	no description	Unknown	optional
Upper chamber	`Upperchamber` `Upperhouse`	The state's upper legislative chamber Example [[California State Senate\|State Senate]]	Content	suggested
Lower chamber	`Lowerchamber` `Lowerhouse`	The state's lower legislative chamber Example [[California State Assembly\|State Assembly]]	Content	suggested
Senators	`Senators`	The state's Senators in the US Senate Example {{ublist\|[[Dianne Feinstein]] (D)\|[[Kamala Harris]] (D)}}	Content	required
Representatives	`Representatives`	The state's number of representatives in the House of Representatives by political party Example {{ublist\|46 Democrats\|7 Republicans}}	Content	required
timezone1	`timezone1`	no description	Unknown	optional
utc_offset1	`utc_offset1`	no description	Unknown	optional
timezone1_DST	`timezone1_DST`	no description	Unknown	optional
utc_offset1_DST	`utc_offset1_DST`	no description	Unknown	optional
timezone1_location	`timezone1_location`	no description	Unknown	optional
timezone2	`timezone2`	no description	Unknown	optional
utc_offset2	`utc_offset2`	no description	Unknown	optional
timezone2_DST	`timezone2_DST`	no description	Unknown	optional
utc_offset2_DST	`utc_offset2_DST`	no description	Unknown	optional
timezone2_location	`timezone2_location`	no description	Unknown	optional
Postal abbreviation	`PostalAbbreviation`	Official 2-letter abbreviation of the state Example CA	String	optional
Traditional abbreviation(s)	`TradAbbreviation`	The state's traditional abbreviation(s) Example Calif., Cal.	String	optional
Official name	`official_name`	The state's official name. Use only when not of the form 'State of X' Example Commonwealth of Virginia	String	optional
Area codes	`area_code`	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	String	optional
ISO code	`iso_code`	no description Example US-CA	String	optional
Official website	`website`	The state's official website Example https://www.ca.gov/	URL	optional
Seal alternate text	`seal_alt`	no description	String	optional
Link to flag's page	`flag_link`	Link to the Wikipedia page of the state's flag Example Flag of California	Page name	optional
Seal image	`image_seal`	An image of the state's seal	File	optional
Name	`name`	The state's name Example California	String	optional
Flag image	`image_flag`	An image of the state's flag Example Flag of California.svg	File	optional
Flag alternate text	`flag_alt`	no description	String	optional
State nickname	`nickname`	The state's nickname Example The Golden State	String	optional
State nicknames	`nicknames`	The state's nicknames, if there are more than one Example The Constitution State (official), The Nutmeg State	Content	optional
Footnotes	`footnotes`	no description	Content	optional
Map alternate text	`map_alt`	no description	String	optional
Map image	`image_map`	no description Example California in United States.svg	File	optional
State anthem	`anthem`	The state's anthem Example "[[I Love You, California]]"<br />[[File:"I Love You, California" - Regional anthem of California.ogg\|center]]	Content	optional
State motto	`motto`	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>	Content	optional
Demonym	`population_demonym`	What the state's residents are called Example Californian	String	suggested
Area rank	`area_rank`	no description Example 3rd	String	optional
Total area	`total_area`	no description	Number	optional
Module	`module`	no description	String	optional

The documentation on top is transcluded from Template:Infobox U.S. state/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.