Lihimi Tɛmplet:US Census population/doc ni yi shɛli na

{{Documentation subpage}}
{{Lua|Module:String}}
{{Uses TemplateStyles|Template:US Census population/styles.css}}

This template is used as an information box on pages, showing each census year with a population, and a percent gain/loss comparison. See [[Alabama#Demographics|Alabama]] as an example of how this template is rendered.

== Usage ==
<pre>
{{US Census population
| align=
| 1790=
| 1800=
| 1810=
| 1820=
| 1830=
| 1840=
| 1850=
| 1860=
| 1870=
| 1880=
| 1890=
| 1900=
| 1910=
| 1920=
| 1930=
| 1940=
| 1950=
| 1960=
| 1970=
| 1980=
| 1990=
| 2000=
| 2010=
| 2020= <!--As of April 2021, the template should be used with either 2020= or estimate=, but not both.-->
| estyear=
| estimate=
| estref=
| align-fn=
| footnote=
}}</pre>


== Example ==
{{Nowiki template demo|code=<nowiki>{{US Census population
|align=center
|title=Alabama Census Results 1800-2020
|1800= 1250
|1810= 9046
|1820= 144317 |1820n= {{refn|1=Forstall, Richard L. (1996). ''[https://www2.census.gov/library/publications/decennial/1990/population-of-states-and-counties-us-1790-1990/population-of-states-and-counties-of-the-united-states-1790-1990.pdf#page=21 Population of States and Counties of the United States: 1790 to 1990]''. Washington: U.S. Bureau of the Census, pp. 8–11. ISBN 0-934213-48-8. Retrieved 19 May 2021. Due to the late arrival of returns from the counties of [[Lawrence County, Alabama|Lawrence]], [[Perry County, Alabama|Perry]], and [[Washington County, Alabama|Washington]], the population of the state for 1820 was incorrectly listed as 127,901 in the official state total.{{refn|group=subnote|1=The relevant note on p. 10 erroneously switches the population values for Perry and Washington counties. The correct values can be found on [https://www2.census.gov/library/publications/decennial/1820/1820a-02.pdf#page=109 page 121] of the final census report for 1820.}}}}
|1830= 309527
|1840= 590756
|1850= 771623
|1860= 964201
|1870= 996992
|1880= 1262505
|1890= 1513401
|1900= 1828697
|1910= 2138093
|1920= 2348174
|1930= 2646248
|1940= 2832961
|1950= 3061743
|1960= 3266740
|1970= 3444165
|1980= 3893888
|1990= 4040587
|2000= 4447100
|2010= 4779736
|2020= 5024279
|estimate=5039877
|estyear=2021
|align-fn=center
|footnote=Sources: 1910–2020<ref name="Census2010">[https://www.census.gov/data/tables/time-series/dec/popchange-data-text.html Historical Population Change Data (1910–2020)] {{webarchive |url=https://web.archive.org/web/20210429012609/https://www.census.gov/data/tables/time-series/dec/popchange-data-text.html |date=April 29, 2021}}</ref>
}}</nowiki>}}

=== Parameters ===
* {{para|align}} sets infobox alignment; values:
** '''right''' float on the right side of the page; default
** '''left''' to float it to the left
** '''center''' for center alignment
** '''none''' for left alignment, without wrapping text
* {{para|align-fn}}: alignment of footnote
** '''left'''
** '''right'''
** '''center''' default

== Tracking category ==
* {{clc|Pages using US Census population with a URL footnote}}
* {{clc|Pages using US Census population needing update}}
* {{clc|Pages using US Census population with unknown parameters}}

== See also ==
* {{tl|Historical populations}}

==Template Data for Visual Editor==
{{templatedata header}}
<templatedata>
{
	"params": {
		"1790": {
			"label": "1790 Census result (population)",
			"description": "How many people were recorded by the 1790 census?",
			"type": "number"
		},
		"1800": {
			"label": "1800 Census result (population)",
			"description": "How many people were recorded by the 1800 census?",
			"type": "number"
		},
		"1810": {
			"label": "1810 Census result (population)",
			"description": "How many people were recorded by the 1810 census?",
			"type": "number"
		},
		"1820": {
			"label": "1820 Census result (population)",
			"description": "How many people were recorded by the 1820 census?",
			"type": "number"
		},
		"1830": {
			"label": "1830 Census result (population)",
			"description": "How many people were recorded by the 1830 census?",
			"type": "number"
		},
		"1840": {
			"label": "1840 Census result (population)",
			"description": "How many people were recorded by the 1840 census?",
			"type": "number"
		},
		"1850": {
			"label": "1850 Census result (population)",
			"description": "How many people were recorded by the 1850 census?",
			"type": "number"
		},
		"1860": {
			"label": "1860 Census result (population)",
			"description": "How many people were recorded by the 1860 census?",
			"type": "number"
		},
		"1870": {
			"label": "1870 Census result (population)",
			"description": "How many people were recorded by the 1870 census?",
			"type": "number"
		},
		"1880": {
			"label": "1880 Census result (population)",
			"description": "How many people were recorded by the 1880 census?",
			"type": "number"
		},
		"1890": {
			"label": "1890 Census result (population)",
			"description": "How many people were recorded by the 1890 census?",
			"type": "number"
		},
		"1900": {
			"label": "1900 Census result (population)",
			"description": "How many people were recorded by the 1900 census?",
			"type": "number"
		},
		"1910": {
			"label": "1910 Census result (population)",
			"description": "How many people were recorded by the 1910 census?",
			"type": "number"
		},
		"1920": {
			"label": "1920 Census result (population)",
			"description": "How many people were recorded by the 1920 census?",
			"type": "number"
		},
		"1930": {
			"label": "1930 Census result (population)",
			"description": "How many people were recorded by the 1930 census?",
			"type": "number"
		},
		"1940": {
			"label": "1940 Census result (population)",
			"description": "How many people were recorded by the 1940 census?",
			"type": "number"
		},
		"1950": {
			"label": "1950 Census result (population)",
			"description": "How many people were recorded by the 1950 census?",
			"type": "number"
		},
		"1960": {
			"label": "1960 Census result (population)",
			"description": "How many people were recorded by the 1960 census?",
			"type": "number"
		},
		"1970": {
			"label": "1970 Census result (population)",
			"description": "How many people were recorded by the 1970 census?",
			"type": "number"
		},
		"1980": {
			"label": "1980 Census result (population)",
			"description": "How many people were recorded by the 1980 census?",
			"type": "number"
		},
		"1990": {
			"label": "1990 Census result (population)",
			"description": "How many people were recorded by the 1990 census?",
			"type": "number"
		},
		"2000": {
			"label": "2000 Census result (population)",
			"description": "How many people were recorded by the 2000 census?",
			"type": "number"
		},
		"2010": {
			"label": "2010 Census result (population)",
			"description": "How many people were recorded by the 2010 census?",
			"type": "number"
		},
		"2020": {
			"label": "2020 Census result (population)",
			"description": "How many people were recorded by the 2020 census?",
			"type": "number"
		},
		"1790n": {
			"label": "1790 census citation",
			"description": "Cite your source for the 1790 Census",
			"type": "content"
		},
		"1800n": {
			"label": "1800 Census citation",
			"description": "Cite your source for the 1800 Census",
			"type": "content"
		},
		"1810n": {
			"label": "1810 Census citation",
			"description": "Cite your source for the 1810 Census",
			"type": "content"
		},
		"1820n": {
			"label": "1820 Census citation",
			"description": "Cite your source for the 1820 Census",
			"type": "content"
		},
		"align": {
			"label": "infobox alignment",
			"description": "sets infobox alignment. right -> float on the right side of the page; default. left -> to float it to the left. center -> center alignment. none -> left alignment, without wrapping text",
			"example": "right",
			"type": "string",
			"suggestedvalues": [
				"right",
				"left",
				"center",
				"none"
			],
			"default": "right",
			"suggested": true
		},
		"title": {
			"label": "Title",
			"description": "Sets a title for the infobox. If unspecified, defaults to 'Historical Population'",
			"example": "Census data for Alabama",
			"type": "string",
			"default": "Historical Population",
			"suggested": true
		},
		"1830n": {
			"label": "1830 Census citation",
			"description": "Cite your source for the 1830 Census",
			"type": "content"
		},
		"1840n": {
			"label": "1840 Census citation",
			"description": "Cite your source for the 1840 Census",
			"type": "content"
		},
		"1850n": {
			"label": "1850 Census citation",
			"description": "Cite your source for the 1850 Census",
			"type": "content"
		},
		"1860n": {
			"label": "1860 Census citation",
			"description": "Cite your source for the 1860 Census",
			"type": "content"
		},
		"1870n": {
			"label": "1870 Census citation",
			"description": "Cite your source for the 1870 Census",
			"type": "content"
		},
		"1880n": {
			"label": "1880 Census citation",
			"description": "Cite your source for the 1880 Census",
			"type": "content"
		},
		"1890n": {
			"label": "1890 Census citation",
			"description": "Cite your source for the 1890 Census",
			"type": "content"
		},
		"1900n": {
			"label": "1900 Census citation",
			"description": "Cite your source for the 1900 Census",
			"type": "content"
		},
		"1910n": {
			"label": "1910 Census citation",
			"description": "Cite your source for the 1910 Census",
			"type": "content"
		},
		"1920n": {
			"label": "1920 Census citation",
			"description": "Cite your source for the 1920 Census",
			"type": "content"
		},
		"1930n": {
			"label": "1930 Census citation",
			"description": "Cite your source for the 1930 Census",
			"type": "content"
		},
		"1940n": {
			"label": "1940 Census citation",
			"description": "Cite your source for the 1940 Census",
			"type": "content"
		},
		"1950n": {
			"label": "1950 Census citation",
			"description": "Cite your source for the 1950 Census",
			"type": "content"
		},
		"1960n": {
			"label": "1960 Census citation",
			"description": "Cite your source for the 1960 Census",
			"type": "content"
		},
		"1970n": {
			"label": "1970 Census citation",
			"description": "Cite your source for the 1970 Census",
			"type": "content"
		},
		"1980n": {
			"label": "1980 Census citation",
			"description": "Cite your source for the 1980 Census",
			"type": "content"
		},
		"1990n": {
			"label": "1990 Census citation",
			"description": "Cite your source for the 1990 Census",
			"type": "content"
		},
		"2000n": {
			"label": "2000 Census citation",
			"description": "Cite your source for the 2000 Census",
			"type": "content"
		},
		"2010n": {
			"label": "2010 Census citation",
			"description": "Cite your source for the 2010 Census",
			"type": "content"
		},
		"2020n": {
			"label": "2020 Census citation",
			"description": "Cite your source for the 2020 Census",
			"type": "content"
		},
		"estimate": {
			"label": "Estimated population (number of people) for a year which didn't have a census. Generally used for 'estimated current population'.",
			"description": "MUST BE USED WITH estyear (year of population estimate) AND estref (estimated population reference) VALUES!. Generally used for 'estimated current population'.",
			"example": "241,000",
			"type": "number"
		},
		"estyear": {
			"label": "Year of population estimate",
			"description": "The year which the specified 'estimated population' is an estimate for. (If you have an estimate for the 2022 population, enter '2022').",
			"example": "2022",
			"type": "number"
		},
		"estref": {
			"label": "Population estimate citation",
			"description": "Enter the citation for the population estimate (if population estimate has been specified)",
			"type": "content"
		},
		"footnote": {
			"label": "Footnote",
			"description": "Can be used to add a footnote to this infobox. Use cases include adding a citation to a single consolidated reference for the census data in the entire infobox, along the lines of 'sources 1910-2022[REF GOES HERE]'",
			"type": "content",
			"suggested": true
		},
		"align-fn": {
			"label": "alignment of footnote",
			"type": "string",
			"suggestedvalues": [
				"left",
				"right",
				"center"
			],
			"default": "center",
			"description": "Can be used to set the alignment of the footnote. left -> left-aligned. right -> right-aligned. center -> content centered (default)."
		}
	},
	"format": "block",
	"description": "This template is used as an information box on pages, showing each census year with a population, and a percent gain/loss comparison. Also includes functionality for a custom title/footer for the infobox, easy-to-insert citations for each census year, and population estimates for a single non-census year (with an easy-to-insert citation thing for this as well).",
	"paramOrder": [
		"title",
		"align",
		"footnote",
		"align-fn",
		"1790",
		"1790n",
		"1800",
		"1800n",
		"1810",
		"1810n",
		"1820",
		"1820n",
		"1830",
		"1830n",
		"1840",
		"1840n",
		"1850",
		"1850n",
		"1860",
		"1860n",
		"1870",
		"1870n",
		"1880",
		"1880n",
		"1890",
		"1890n",
		"1900",
		"1900n",
		"1910",
		"1910n",
		"1920",
		"1920n",
		"1930",
		"1930n",
		"1940",
		"1940n",
		"1950",
		"1950n",
		"1960",
		"1960n",
		"1970",
		"1970n",
		"1980",
		"1980n",
		"1990",
		"1990n",
		"2000",
		"2000n",
		"2010",
		"2010n",
		"2020",
		"2020n",
		"estyear",
		"estimate",
		"estref"
	]
}
</templatedata>

=== References and Notes (used in the example) ===
==== Notes ====
{{reflist|group=subnote}}
==== References ====
{{reflist}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:United States society and social science sidebar templates|Census Population]]
[[Category:United States history sidebar templates|Census Population]]
[[Category:Population templates]]
[[Category:Templates that add a tracking category]]
}}</includeonly>