{{Historical populations}} is used as an information box on pages showing each census year with a population and a percent gain/loss comparison. It is intended to combine the functionalities of two existing templates, Template:US Census population and Template:Histpop, the former of which is specialized for the United States, and the latter of which lacks many features of the former.
This template takes a series of parameters in the form |date |population. This template does not require any more than that. This template will take between 0 and 50 entries; any more will be ignored.
The population of row n. Must be a plain number with no formatting (commas, etc.).
title
Optional. The title of the table.
Historical population (Default)
align
Optional. The alignment of the table on the page.
right (Default)
left
center
none
clear
Optional. Use to clear any left or right floating elements nearby.
right (Default if align = right)
left (Default if align = left)
none (Default if align = none)
both
direction
Optional. How the box is arranged on the page.
vertical (Default)
horizontal
percentages
Optional. Whether to include an automatically generated column of percent differences. This works best with linear lists (1900, 1910, 1920, etc.). Alternately, you can specify "pagr" to display annual growth rates (per annum growth rate) using the formula from Population growth.
on (Default)
pagr
off
state
Optional. The collapsed state of the table. Set it to collapsed to collapse the table by default.
none (Default)
collapsed
type
Optional. This is designed to add functionality specific to different regions or types of information. Currently the only value that does anything is US (or the obsolescent USA).
none (Default)
US Will link each year to the relevant United States census entry. Years that do not have entries will be left alone.
Please think of more ideas for this feature.
shading
Optional. Whether to mark off every five entries with a line, to facilitate reading. This works best with large, linear lists (such as the US Census, which has been taken every 10 years for over 200 years), but should probably be turned off for small or irregular lists (e.g., less than 10 entries), where it could be confusing.
on (Default)
off
width
Optional. The width of the table (or of each block of columns). Can be any valid CSS width value.
15em (Default)
pop_name
Optional. The text in the column header of the population data.
{{abbr|Pop.|Population}} (Default, displays as Pop.)
footnote
Optional. Free-form footnote. Can be used as a variant to, or in addition to, the source parameter.
source
Optional. Displayed as a footnote under the table with the text "Source:" inserted automatically. Every table should indicate the source of the data.
graph-pos
Optional. Adds an automatically generated graph at the top (with |graph-pos=top) or bottom (with |graph-pos=bottom)
graph-width
Optional. Overrides the default width of the graph. Should not be necessary in most cases.
graph-height
Optional. Overrides the default height of the graph. Should not be necessary in most cases.
cols
Optional. Total number of columns of data (default is 1). This is useful for very long tables, or when |align=none.