Template:Infobox settlement/doc

This template should be used to produce an Infobox for human settlements (cities, towns, villages, communities) as well as other administrative districts, counties, provinces, etcetera - in fact, any subdivision below the level of a country, for which Infobox country should be used. Parameters are described in the table below. For questions see the talk page.

Usage

 * Important: Please enter all numeric values in a raw, unformatted fashion. References are to be included in their respective section footnotes field.  Numeric values that are not "raw" may create an "Expression error". Raw values will be automatically formatted by the template.  If you find a raw value is not formatted in your usage of the template, please post a notice on the discussion page for this template.
 * An expression error may also occur when any coordinate parameter has a value, but one or more coordinate parameters are blank or invalid.

Basic blank template, ready to cut and paste. See the next section for a copy of the template with all parameters and comments. See the table below that for a full description of each parameter.

Using metric units


Using non-metric units


Complete empty syntax, with comments
This copy of the template lists all parameters except for some of the repeating numbered parameters which are noted in the comments. Comments here should be brief; see the table below for full descriptions of each parameter.



Parameter names and descriptions
{| class="wikitable" style="background: white" ! colspan=3 style="background: orange;" |

Name and transliteration
! Parameter name !! Usage !! Description
 * - style="background: whitesmoke;"


 * - valign=top
 * name || optional || This is the usual name in English. If it's not specified, the infobox will use the official_name as a title unless this too is missing, in which case the page name will be used.
 * - valign=top
 * official_name || optional || The official name in English if different from name
 * - valign=top
 * native_name || optional || This will display under the name/official name
 * - valign=top
 * native_name_lang || optional || Use ISO 639-2 code, e.g. "fr" for French. If there is more than one native name, in different languages, enter those names using lang, instead.
 * - valign=top
 * other_name || optional || For places with a former or more common name like Bombay or Saigon
 * - valign=top
 * settlement_type || optional || Any type can be entered, such as City, Town, Village, Hamlet, Municipality, Reservation, etc. If set, will be displayed under the names, provided that either name or official_name is filled in. Might also be used as a label for total population/area (defaulting to City), if needed to distinguish from Urban, Rural or Metro (if urban, rural or metro figures are not present, the label is Total unless total_type is set).

! colspan=3 style="background: #DDDDDD;" | Transliteration(s)
 * - valign=top
 * - valign=top
 * translit_lang1 || optional || Will place the "entry" before the word "transliteration(s)". Can be used to specify a particular language like in Dêlêg or one may just enter "Other", like in Gaza's article.
 * - valign=top
 * translit_lang1_type translit_lang1_type1 to translit_lang1_type6 || optional ||
 * - valign=top
 * translit_lang1_info translit_lang1_info1 to translit_lang1_info6 || optional ||
 * - valign=top
 * translit_lang2 || optional || Will place a second transliteration. See Dêlêg
 * - valign=top
 * translit_lang2_type translit_lang2_type1 to translit_lang2_type6 || optional ||
 * - valign=top
 * translit_lang2_info translit_lang2_info1 to translit_lang2_info6 || optional ||

! colspan=3 style="background: orange;" |
 * - valign=top

Images, nickname, motto
! Parameter name !! Usage !! Description
 * - style="background: whitesmoke;"

! colspan=3 style="background: #DDDDDD;" | Skyline image
 * - valign=top
 * - valign=top
 * image_skyline || optional || Despite the name it can be any image that an editor wishes.
 * - valign=top
 * imagesize || optional || Can be used to tweak the size of the image_skyline up or down. This can be helpful if an editor want to make the infobox wider. If used, px must be specified; default size is 250px.
 * - valign=top
 * image_alt || optional || Alt text for the image, used by visually impaired readers who cannot see the image. See WP:ALT.
 * - valign=top
 * image_caption || optional || Will place a caption under the image_skyline (if present)

! colspan=3 style="background: #DDDDDD;" | Flag image
 * - valign=top
 * - valign=top
 * image_flag || optional || Used for a flag.
 * - valign=top
 * flag_size || optional || Can be used to tweak the size of the image_flag up or down from 100px as desired. If used, px must be specified; default size is 100px.
 * - valign=top
 * flag_alt || optional || Alt text for the flag.
 * - valign=top
 * flag_link || optional ||

! colspan=3 style="background: #DDDDDD;" | Seal image
 * - valign=top
 * - valign=top
 * image_seal || optional || If the place has an official seal.
 * - valign=top
 * seal_size || optional || If used, px must be specified; default size is 100px.
 * - valign=top
 * seal_alt || optional || Alt text for the seal.
 * - valign=top
 * seal_link || optional ||

! colspan=3 style="background: #DDDDDD;" | Coat of arms image
 * - valign=top
 * - valign=top
 * image_shield || optional || Can be used for a place with a coat of arms.
 * - valign=top
 * shield_size || optional || If used, px must be specified; default size is 100px.
 * - valign=top
 * shield_alt || optional || Alt text for the shield.
 * - valign=top
 * shield_link || optional || Can be used if a wiki article if known but is not automatically linked by the template. See Coquitlam, British Columbia's infobox for an example.

! colspan=3 style="background: #DDDDDD;" | Logo or emblem image ! colspan=3 style="background: #DDDDDD;" | Nickname, motto ! colspan=3 style="background: orange;" |
 * - valign=top
 * - valign=top
 * image_blank_emblem || optional || Can be used if a place has an official logo, crest, emblem, etc. Logo is the default type. See Kingston upon Hull's infobox for an example.
 * - valign=top
 * blank_emblem_type || optional || To specify what type of emblem "image_blank_emblem" is. The default is Logo.
 * - valign=top
 * blank_emblem_size || optional || If used, px must be specified; default size is 100px.
 * - valign=top
 * blank_emblem_alt || optional || Alt text for blank emblem.
 * - valign=top
 * blank_emblem_link || optional ||
 * - valign=top
 * - valign=top
 * nickname || optional || well-known nickname(s)
 * - valign=top
 * motto || optional || Will place the motto under the nicknames
 * - valign=top
 * anthem || optional || Will place the anthem (song) under the nicknames
 * - valign=top

Maps, coordinates
! Parameter name !! Usage !! Description
 * - style="background: whitesmoke;"

! colspan=3 style="background: #DDDDDD;" | Map images
 * - valign=top
 * - valign=top
 * image_map || optional ||
 * - valign=top
 * mapsize || optional || If used, px must be specified; default is 250px.
 * - valign=top
 * map_alt || optional || Alt text for map.
 * - valign=top
 * map_caption || optional ||
 * - valign=top
 * image_map1 || optional || A secondary map image. The field image_map must be filled in first. Example see: Bloomsburg, Pennsylvania.
 * - valign=top
 * mapsize1 || optional || If used, px must be specified; default is 250px.
 * - valign=top
 * map_alt1 || optional || Alt text for secondary map.
 * - valign=top
 * map_caption1 || optional ||

! colspan=3 style="background: #DDDDDD;" | Dot map
 * - valign=top
 * - valign=top
 * image_dot_map || optional || A field for manually superimposing a dot over a blank map using an "X" & "Y" system. Blank maps, if available, can be found over at Wikimedia Commons. Example see: Rainbow Lake, Alberta
 * - valign=top
 * dot_mapsize || optional || To change the dot map size; default is 180px (px is optional).
 * - valign=top
 * dot_map_base_alt || optional ||
 * - valign=top
 * dot_map_alt || optional || Alt text for the dot map.
 * - valign=top
 * dot_map_caption || optional || For placing a caption under the dot map.
 * - valign=top
 * dot_x dot_y || optional || For manually superimposing the dot left/right and up/down on the map.

! colspan=3 style="background: #DDDDDD;" | Pushpin map(s), coordinates
 * - valign=top
 * - valign=top
 * pushpin_map || optional || The name of a location map as per Template:Location map (e.g. Indonesia or Russia). The coordinate fields (e.g. latd and longd) position a pushpin coordinate marker and label on the map automatically. Example see: Padang, Indonesia
 * - valign=top
 * pushpin_label_position || optional || The position of the label on the pushpin map relative to the pushpin coordinate marker. Valid options are {left, right, top, bottom, none}. If this field is not specified, the default value is right.
 * - valign=top
 * pushpin_map_alt || optional || Alt text for pushpin map.
 * - valign=top
 * pushpin_mapsize || optional || Must be entered as only a number&mdash;do not use px. The default value is 250.
 * - valign=top
 * pushpin_map_caption || optional || Fill out if a different caption from map_caption is desired.
 * - valign=top
 * pushpin_relief || optional || Set this to  or any non-blank value to use an alternative relief map provided by the selected location map (if a relief map is available).
 * - valign=top
 * pushpin_map1 || optional || Set of parameters for second pushpin map
 * - valign=top
 * pushpin_label_position1 || optional ||
 * - valign=top
 * pushpin_map_alt1 || optional ||
 * - valign=top
 * pushpin_mapsize1 || optional || Must be entered as only a number&mdash;do not use px.
 * - valign=top
 * pushpin_map_caption1 || optional ||
 * - valign=top
 * pushpin_relief1 || optional ||
 * - valign=top
 * latd || optional || Latitude degrees. Can also be used for decimal degrees.
 * - valign=top
 * latm || optional || Latitude minutes. Omit or leave blank if latd has a decimal value.
 * - valign=top
 * lats || optional || Latitude seconds. Omit or leave blank if latd has a decimal value.
 * - valign=top
 * latNS || optional || Latitude North or South (enter N or S). Omit or leave blank if latd has a decimal value.
 * - valign=top
 * longd || optional || Longitude degrees. Can also be used for decimal degrees.
 * - valign=top
 * longm || optional || Longitude minutes. Omit or leave blank if longd has a decimal value.
 * - valign=top
 * longs || optional || Longitude seconds. Omit or leave blank if longd has a decimal value.
 * - valign=top
 * longEW || optional || Longitude East or West (enter E or W). Omit or leave blank if longd has a decimal value.

! colspan=3 style="background: #DDDDDD;" | Coordinates display If coordinates_region is omitted or blank, region: will be set according to subdivision_name, using CountryAbbr. For example, subdivision_name = United Kingdom will generate coordinates with "region:GB". In addition, for Canada, India, and the United States, subdivision_name1 will be used to determine the region. For example: subdivision_name=Canada and subdivision_name1=Ontario will yield "region:CA-ON". coordinates_type (below) overrides this parameter. If coordinates_type is omitted or blank: Any value other than  will have the coordinates displayed in the article's title as well. Infobox settlement uses Geobox coor to call Coord with the parameter "display=inline,title".
 * - valign=top
 * - valign=top
 * coor_pinpoint || optional || If needed, to specify more exactly where (or what) coordinates are given (e.g. Town Hall) or a specific place in a larger area (e.g. a city in a county). Example: Masovian Voivodeship
 * - valign=top
 * coordinates_region || optional
 * Can be used to override the default region: for the coordinates. Use either a two character ISO 3166-1 alpha-2 country code or an ISO 3166-2 region code.
 * - valign=top
 * coordinates_type || optional
 * Can be used to override the default coordinate parameters for the coordinates. May include type:, scale:, dim:, region:, and/or source:, joined by underscores ("_").
 * scale:, dim:, and source: will be left unspecified.
 * region: will be set by coordinates_region (above), subdivision_name and subdivision_name1 (below), and
 * type: will be set to "type:city" if the population_total field is omitted or blank. If population_total is a number without commas, "type:city(population_total)" is used. But if population_total includes letters or punctuation, "type:city" is used.
 * - valign=top
 * coordinates_display || optional
 * If the parameter is omitted, blank, or equal to, the coordinates will be displayed in the infobox only.
 * - valign=top
 * coordinates_format || optional
 * If the parameter is omitted or blank, the coordinates format will match the format in which the coordinates are specified Set to dms to force degrees/minutes/seconds or dec to force decimal.
 * - valign=top
 * coordinates_footnotes || optional || Reference(s) for coordinates, placed within tags, possibly using the citing format at Cite web

! colspan=3 style="background: orange;" |
 * - valign=top

Location, established, seat, subdivisions, government, leaders
! Parameter name !! Usage !! Description
 * - style="background: whitesmoke;"

! colspan=3 style="background: #DDDDDD;" | Location
 * - valign=top
 * - valign=top
 * subdivision_type || optional || almost always  Country 
 * - valign=top
 * subdivision_name || optional || Depends on the subdivision_type - use the name in text form, sample: United States or  United States , flag icons or flag templates can be used in this field.
 * - valign=top
 * subdivision_type1 to subdivision_type6 || optional || Can be State/Province, region, county.
 * - valign=top
 * subdivision_name1 to subdivision_name6 || optional || Use the name in text form, sample: Florida or  Florida . Flag icons or flag templates can be used in this field per WP:MOSFLAG.

! colspan=3 style="background: #DDDDDD;" | Established
 * - valign=top
 * - valign=top
 * established_title || optional || Example: First settled
 * - valign=top
 * established_date || optional ||
 * - valign=top
 * established_title1 || optional || Example: Incorporated (town)
 * - valign=top
 * established_date1 || optional ||
 * - valign=top
 * established_title2 || optional || Example: Incorporated (city)
 * - valign=top
 * established_date2 || optional ||
 * - valign=top
 * established_title3 || optional ||
 * - valign=top
 * established_date3 || optional ||
 * - valign=top
 * extinct_title || optional || For when a settlement ceases to exist
 * - valign=top
 * extinct_date || optional ||
 * - valign=top
 * founder || optional || The name of the settlement's founder
 * - valign=top
 * named_for || optional || The source of the name of the settlement (a person, a place, et cetera)

! colspan=3 style="background: #DDDDDD;" | Seat of government
 * - valign=top
 * - valign=top
 * seat_type || optional || The label for the seat of government (defaults to Seat).
 * - valign=top
 * seat || optional || The seat of government.

! colspan=3 style="background: #DDDDDD;" | Smaller parts (e.g. boroughs of a city)
 * - valign=top
 * - valign=top
 * parts_type || optional || The label for the smaller subdivisions (defaults to Boroughs).
 * - valign=top
 * parts_style || optional || Set to list to display as a collapsible list, coll as a collapsed list, or para to use paragraph style. Default is list for up to 5 items, otherwise coll.
 * - valign=top
 * parts || optional || Text or header of the list of smaller subdivisions.
 * - valign=top
 * p1 p2 to p50 || optional || The smaller subdivisions to be listed. Example: Warsaw

! colspan=3 style="background: #DDDDDD;" | Government type, leaders
 * - valign=top
 * - valign=top
 * government_footnotes || optional || Reference(s) for government, placed within tags, possibly using the citing format at Cite web
 * - valign=top
 * government_type || optional || Example: Mayor-council government
 * - valign=top
 * governing_body || optional || Name of the place's governing body
 * - valign=top
 * leader_party || optional || Political party of the place's leader
 * - valign=top
 * leader_title || optional || First title of the place's leader, e.g. Mayor
 * - valign=top
 * leader_name || optional || Name of the place's leader
 * - valign=top
 * leader_title1 to leader_title4 || optional ||
 * - valign=top
 * leader_name1 to leader_name4 || optional || For long lists use Collapsible list. See Halifax for an example.

! colspan=3 style="background: orange;" |
 * - valign=top

Geographic information
! Parameter name !! Usage !! Description
 * - valign=top
 * colspan=3 | These fields have dual automatic unit conversion meaning that if only metric values are entered, the imperial values will be automatically converted and vice versa. If an editor wishes to over-ride the automatic conversion, e.g. if the source gives both metric and imperial or if a range of values is needed, they should enter both values in their respective fields.
 * - style="background: whitesmoke;"

! colspan=3 style="background: #DDDDDD;" | Display settings
 * - valign=top
 * - valign=top
 * total_type || optional || Specifies what "total" area and population figure refer to, e.g. Greater London. This overrides other labels for total population/area. To make the total area and population display on the same line as the words "Area" and "Population", with no "Total" or similar label, set the value of this parameter to &nbsp&#59;.
 * - valign=top
 * unit_pref || optional || To change the unit order to imperial (metric), enter imperial. The default display style is metric (imperial). However, the template will swap the order automatically if the subdivision_name equals some variation of the USA or the UK. For the middle east, a unit preference of dunam can be entered (only affects total area). All values must be entered in a raw format: no commas, spaces, or unit symbols. The template will format them automatically.

! colspan=3 style="background: #DDDDDD;" | Area
 * - valign=top
 * - valign=top
 * area_footnotes || optional || Reference(s) for area, placed within tags, possibly using the citing format at Cite web
 * - valign=top
 * area_magnitude || optional || Setting this to any non-empty value will create a link to the appropriate order of magnitude of area page (e.g. 1 E+6 m²).
 * - valign=top
 * dunam_link || optional || If dunams are used, the default is to link the word dunams in the total area section. This can be changed by setting   to another measure (e.g.  ).  Linking can also be turned off by setting the parameter to something else (e.g.    or   ).
 * - valign=top
 * area_total_km2 || optional || Total area in square kilometers&mdash;symbol: km2. Value must be entered in raw format, no commas or spaces. Auto-converted to display square miles if area_total_sq_mi is empty.
 * - valign=top
 * area_total_ha || optional || Total area in hectares&mdash;symbol: ha. Value must be entered in raw format, no commas or spaces. Auto-converted to display acres if area_total_acre is empty.
 * - valign=top
 * area_total_sq_mi || optional || Total area in square miles&mdash;symbol: sq mi. Value must be entered in raw format, no commas or spaces. Auto-converted to display square kilometers if area_total_km2 is empty.
 * - valign=top
 * area_total_acre || optional || Total area in acres. Value must be entered in raw format, no commas or spaces. Auto-converted to display hectares if area_total_ha is empty.
 * - valign=top
 * area_total_dunam || optional || Total area in dunams, which is wiki-linked. Used in middle eastern places like Israel, Gaza, and the West Bank. Value must be entered in raw format, no commas or spaces. Auto-converted to display square kilometers or hectares and square miles or acreds if area_total_km2, area_total_ha, area_total_sq_mi, and area_total_acre are empty. Examples: Gaza and Ramallah
 * - valign=top
 * area_land_km2 || optional || Land area in square kilometers&mdash;symbol: km2. Value must be entered in raw format, no commas or spaces. Auto-converted to display square miles if area_land_sq_mi is empty.
 * - valign=top
 * area_land_sq_mi || optional || Land area in square miles&mdash;symbol: sq mi. Value must be entered in raw format, no commas or spaces. Auto-converted to display square kilometers if area_land_km2 is empty.
 * - valign=top
 * area_land_ha || optional || similar to
 * - valign=top
 * area_land_dunam || optional || similar to
 * - valign=top
 * area_land_acre || optional || similar to
 * - valign=top
 * area_water_km2 || optional || Water area in square kilometers&mdash;symbol: km2. Value must be entered in raw format, no commas or spaces. Auto-converted to display square miles if area_water_sq_mi is empty.
 * - valign=top
 * area_water_sq_mi || optional || Water area in square miles&mdash;symbol: sq mi. Value must be entered in raw format, no commas or spaces. Auto-converted to display square kilometers if area_water_km2 is empty.
 * - valign=top
 * area_water_ha || optional || similar to
 * - valign=top
 * area_water_dunam || optional || similar to
 * - valign=top
 * area_water_acre || optional || similar to
 * - valign=top
 * area_water_percent || optional || percent of water without the "%"
 * - valign=top
 * area_urban_km2 || optional ||
 * - valign=top
 * area_urban_sq_mi || optional ||
 * - valign=top
 * area_urban_ha || optional || similar to
 * - valign=top
 * area_urban_dunam || optional || similar to
 * - valign=top
 * area_urban_acre || optional || similar to
 * - valign=top
 * - valign=top
 * area_rural_km2 || optional ||
 * - valign=top
 * area_rural_sq_mi || optional ||
 * - valign=top
 * area_rural_ha || optional || similar to
 * - valign=top
 * area_rural_dunam || optional || similar to
 * - valign=top
 * area_rural_acre || optional || similar to
 * - valign=top
 * area_metro_km2 || optional ||
 * - valign=top
 * area_metro_sq_mi || optional ||
 * - valign=top
 * area_metro_ha || optional || similar to
 * - valign=top
 * area_metro_dunam || optional || similar to
 * - valign=top
 * area_metro_acre || optional || similar to
 * - valign=top
 * area_rank || optional || The settlement's area, as ranked within its parent sub-division
 * - valign=top
 * area_blank1_title || optional || Example see London
 * - valign=top
 * area_blank1_km2 || optional ||
 * - valign=top
 * area_blank1_sq_mi || optional ||
 * - valign=top
 * area_blank1_ha || optional || similar to
 * - valign=top
 * area_blank1_dunam || optional || similar to
 * - valign=top
 * area_blank1_acre || optional || similar to
 * - valign=top
 * area_blank2_title || optional ||
 * - valign=top
 * area_blank2_km2 || optional ||
 * - valign=top
 * area_blank2_sq_mi || optional ||
 * - valign=top
 * area_blank2_ha || optional || similar to
 * - valign=top
 * area_blank2_dunam || optional || similar to
 * - valign=top
 * area_blank2_acre || optional || similar to
 * - valign=top
 * area_note || optional || A place for additional information such as the name of the source.

! colspan=3 style="background: #DDDDDD;" | Dimensions
 * - valign=top
 * - valign=top
 * dimensions_footnotes || optional || Reference(s) for dimensions, placed within tags, possibly using the citing format at Cite web
 * - valign=top
 * length_km || optional || Raw number entered in kilometers. Will automatically convert to display length in miles if length_mi is empty.
 * - valign=top
 * length_mi || optional || Raw number entered in miles. Will automatically convert to display length in kilometers if length_km is empty.
 * - valign=top
 * width_km || optional || Raw number entered in kilometers. Will automatically convert to display width in miles if length_mi is empty.
 * - valign=top
 * width_mi || optional || Raw number entered in miles. Will automatically convert to display width in kilometers if length_km is empty.

! colspan=3 style="background: #DDDDDD;" | Elevation
 * - valign=top
 * - valign=top
 * elevation_footnotes || optional || Reference(s) for elevation, placed within tags, possibly using the citing format at Cite web
 * - valign=top
 * elevation_m || optional || Raw number entered in meters. Will automatically convert to display elevation in feet if elevation_ft is empty. However, if a range in elevation (i.e. 5–50 m ) is desired, use the "max" and "min" fields below
 * - valign=top
 * elevation_ft || optional || Raw number, entered in feet. Will automatically convert to display the average elevation in meters if elevation_m field is empty. However, if a range in elevation (i.e. 50–500 ft ) is desired, use the "max" and "min" fields below
 * - valign=top
 * elevation_max_footnotes elevation_min_footnotes || optional || Same as above, but for the "max" and "min" elevations. See Leeds.
 * - valign=top
 * elevation_max_m elevation_max_ft elevation_min_m elevation_min_ft || optional || Used to give highest & lowest elevations, instead of just a single value. Example: Halifax Regional Municipality.

! colspan=3 style="background: orange;" |
 * - valign=top

Population, demographics
! Parameter name !! Usage !! Description
 * - valign=top
 * colspan=3 | The density fields have dual automatic unit conversion meaning that if only metric values are entered, the imperial values will be automatically converted and vice-versa. If an editor wishes to over-ride the automatic conversion, e.g. if the source gives both metric and imperial or if a range of values is needed, they can enter both values in their respective fields. To calculate density with respect to the total area automatically, type auto in place of any density value.
 * - style="background: whitesmoke;"

! colspan=3 style="background: #DDDDDD;" | Population
 * - valign=top
 * - valign=top
 * population_total || optional || Actual population (see below for estimates) preferably consisting of digits only (without any commas)
 * - valign=top
 * population_footnotes || optional || Reference(s) for population, placed within tags
 * - valign=top
 * population_as_of || optional || The year for the population total (usually a census year)
 * - valign=top
 * population_density_km2 || optional ||
 * - valign=top
 * population_density_sq_mi || optional ||
 * - valign=top
 * population_est || optional || Population estimate.
 * - valign=top
 * pop_est_as_of || optional || The year or month & year of the population estimate
 * - valign=top
 * population_urban || optional ||
 * - valign=top
 * population_urban_footnotes || optional || Reference(s) for urban population, placed within tags
 * - valign=top
 * population_density_urban_km2 || optional ||
 * - valign=top
 * population_density_urban_sq_mi || optional ||
 * - valign=top
 * population_rural || optional ||
 * - valign=top
 * population_rural_footnotes || optional || Reference(s) for rural population, placed within tags
 * - valign=top
 * population_density_rural_km2 || optional ||
 * - valign=top
 * population_density_rural_sq_mi || optional ||
 * - valign=top
 * population_metro || optional ||
 * - valign=top
 * population_metro_footnotes || optional || Reference(s) for metro population, placed within tags
 * - valign=top
 * population_density_metro_km2 || optional ||
 * - valign=top
 * population_density_metro_sq_mi || optional ||
 * - valign=top
 * population_rank || optional || The settlement's population, as ranked within its parent sub-division
 * - valign=top
 * population_density_rank || optional || The settlement's population density, as ranked within its parent sub-division
 * - valign=top
 * population_blank1_title || optional || Can be used for estimates. Example: Windsor, Ontario
 * - valign=top
 * population_blank1 || optional || The population value for blank1_title
 * - valign=top
 * population_density_blank1_km2 || optional ||
 * - valign=top
 * population_density_blank1_sq_mi || optional ||
 * - valign=top
 * population_blank2_title || optional ||
 * - valign=top
 * population_blank2 || optional ||
 * - valign=top
 * population_density_blank2_km2 || optional ||
 * - valign=top
 * population_density_blank2_sq_mi || optional ||
 * - valign=top
 * population_demonym || optional || A demonym or gentilic is a word that denotes the members of a people or the inhabitants of a place. For example citizens in Liverpool are known as Liverpudlians.
 * - valign=top
 * population_note || optional || A place for additional information such as the name of the source. See Windsor, Ontario for example.

! colspan=3 style="background: #DDDDDD;" | Demographics (section 1)
 * - valign=top
 * - valign=top
 * demographics_type1 || optional || Section Header. For example: Ethnicity
 * - valign=top
 * demographics1_footnotes || optional || Reference(s) for demographics section 1, placed within tags, possibly using the citing format at Cite web
 * - valign=top
 * demographics1_title1 to demographics1_title5 || optional || Titles related to demographics_type1. For example: White, Black, Hispanic...
 * - valign=top
 * demographics1_info1 to demographics1_info5 || optional || Information related to the "titles". For example: 50%, 25%, 10%...

! colspan=3 style="background: #DDDDDD;" | Demographics (section 2)
 * - valign=top
 * - valign=top
 * demographics_type2 || optional || A second section header. For example: Languages
 * - valign=top
 * demographics2_footnotes || optional || Reference(s) for demographics section 2, placed within tags, possibly using the citing format at Cite web
 * - valign=top
 * demographics2_title1 to demographics2_title5 || optional || Titles related to demographics_type2. For example: English, French, Arabic...
 * - valign=top
 * demographics2_info1 to demographics2_info5 || optional || Information related to the "titles" for type2. For example: 50%, 25%, 10%...

! colspan=3 style="background: orange;" |
 * - valign=top

Other information
! Parameter name !! Usage !! Description
 * - style="background: whitesmoke;"

! colspan=3 style="background: #DDDDDD;" | Time zone(s)
 * - valign=top
 * - valign=top
 * timezone1 || optional ||
 * - valign=top
 * utc_offset1 || optional ||
 * - valign=top
 * timezone1_DST || optional ||
 * - valign=top
 * utc_offset1_DST || optional ||
 * - valign=top
 * timezone2 || optional || A second timezone field for larger areas such as a Province.
 * - valign=top
 * utc_offset2 || optional ||
 * - valign=top
 * timezone2_DST || optional ||
 * - valign=top
 * utc_offset2_DST || optional ||

! colspan=3 style="background: #DDDDDD;" | Postal code(s) & area code
 * - valign=top
 * - valign=top
 * postal_code_type || optional ||
 * - valign=top
 * postal_code || optional ||
 * - valign=top
 * postal2_code_type || optional ||
 * - valign=top
 * postal2_code || optional ||
 * - valign=top
 * area_code_type || optional || If left blank/not used template will default to "Area code(s)"
 * - valign=top
 * area_code || optional ||
 * - valign=top
 * geocode || optional || See Geocode
 * - valign=top
 * iso_code || optional || See ISO 3166
 * - valign=top
 * registration_plate || optional || See Vehicle registration plate

! colspan=3 style="background: #DDDDDD;" | Twin cities
 * - valign=top
 * - valign=top
 * twin1 to twin9 || optional || Name of a twin city
 * - valign=top
 * twin1_country to twin9_country || optional || Country of the twin city

! colspan=3 style="background: #DDDDDD;" | Blank fields (section 1)
 * - valign=top
 * - valign=top
 * blank_name_sec1 || optional || Fields used to display other information. The name is displayed in bold on the left side of the infobox.
 * - valign=top
 * blank_info_sec1 || optional || The information associated with the blank_name heading. The info is displayed on right side of infobox, in the same row as the name. For an example, see: Warsaw
 * - valign=top
 * blank1_name_sec1 to blank7_name_sec1 || optional || Up to 7 additional fields (8 total) can be displayed in this section
 * - valign=top
 * blank1_info_sec1 to blank7_info_sec1 || optional ||

! colspan=3 style="background: #DDDDDD;" | Blank fields (section 2)
 * - valign=top
 * - valign=top
 * blank_name_sec2 || optional || For a second section of blank fields
 * - valign=top
 * blank_info_sec2 || optional || Example: Beijing
 * - valign=top
 * blank1_name_sec2 to blank7_name_sec2 || optional || Up to 7 additional fields (8 total) can be displayed in this section
 * - valign=top
 * blank1_info_sec2 to blank7_info_sec2 || optional ||

! colspan=3 style="background: #DDDDDD;" | Website, footnotes
 * - valign=top
 * - valign=top
 * website || optional || External link to official website, Use URL, thus: example.com


 * - valign=top
 * footnotes || optional || Text to be displayed at the bottom of the infobox
 * }

Example 1



 * References

Example 2


Redirects and calls
At least other templates call this one and [ many templates redirect here].

Supporting templates
The following is a list of sub-templates used by Infobox settlement. See the [ current list of all sub-templates] for documentation, sandboxes, testcases, etc.
 * 1) Infobox settlement/areadisp
 * 2) Infobox settlement/checkauto
 * 3) Infobox settlement/densdisp
 * 4) Infobox settlement/dunam
 * 5) Infobox settlement/dunam/mag
 * 6) Infobox settlement/impus
 * 7) Infobox settlement/impus/mag
 * 8) Infobox settlement/lengthdisp
 * 9) Infobox settlement/link
 * 10) Infobox settlement/metric
 * 11) Infobox settlement/metric/mag
 * 12) Infobox settlement/pref

TemplateData
{ "description": "an Infobox for human settlements (cities, towns, villages, communities) as well as other administrative districts, counties, provinces, etcetera", "params": { "name": { "label": "name", "description": "This is the usual name in English. If it's not specified, the infobox will use the 'official_name' as a title unless this too is missing, in which case the page name will be used.", "type": "string", "required": false },   "official_name": { "label": "official_name", "description": "The official name in English if different from 'name'", "type": "string", "required": false },

"native_name": { "label": "native_name", "description": "This will display under the name/official name", "type": "string", "required": false },   "native_name_lang": { "label": "native_name_lang", "description": "Use ISO 639-2 code, e.g. 'fr' for French. If there is more than one native name, in different languages, enter those names using, instead.", "type": "string", "required": false },   "other_name": { "label": "other_name", "description": "For places with a former or more common name like Bombay or Saigon", "type": "string", "required": false },   "settlement_type": { "label": "settlement_type", "description": "Any type can be entered, such as City, Town, Village, Hamlet, Municipality, Reservation, etc. If set, will be displayed under the names, provided that either 'name' or 'official_name' is filled in. Might also be used as a label for total population/area (defaulting to City), if needed to distinguish from Urban, Rural or Metro (if urban, rural or metro figures are not present, the label is Total unless 'total_type' is set).", "type": "string", "required": false },   "translit_lang1": { "label": "translit_lang1", "description": "Will place the entry before the word 'transliteration(s)'. Can be used to specify a particular language like in Dêlêg or one may just enter 'Other', like in Gaza's article.", "type": "string", "required": false },   "translit_lang1_type": { "label": "translit_lang1_type", "description": "Parameters translit_lang1_type1, ... translit_lang1_type6 are also available but not documented here", "type": "string", "required": false },   "translit_lang1_info": { "label": "translit_lang1_info", "description": "Parameters translit_lang1_info1, ... translit_lang1_info6 are also available but not documented here", "type": "string", "required": false },

"translit_lang2": { "label": "translit_lang2", "description": "Will place a second transliteration. See Dêlêg", "type": "string", "required": false },   "translit_lang1_type": { "label": "translit_lang1_type", "description": "Parameters translit_lang2_type1, ... translit_lang2_type6 are also available but not documented here", "type": "string", "required": false },   "translit_lang1_info": { "label": "translit_lang1_info", "description": "Parameters translit_lang2_info1, ... translit_lang2_info6 are also available but not documented here", "type": "string", "required": false },

"image_skyline": { "label": "image_skyline", "description": "Despite the name it can be any image that an editor wishes.", "type": "string", "required": false },   "imagesize": { "label": "imagesize", "description": "Can be used to tweak the size of the image_skyline up or down. This can be helpful if an editor want to make the infobox wider. If used, 'px' must be specified; default size is 250px.", "type": "string", "required": false },   "image_alt": { "label": "image_alt", "description": "Alt text for the image, used by visually impaired readers who cannot see the image.", "type": "string", "required": false },   "image_caption": { "label": "image_caption", "description": "Will place a caption under the image_skyline (if present)", "type": "string", "required": false },   "image_flag": { "label": "image_flag", "description": "Used for a flag.", "type": "string", "required": false },   "flag_size": { "label": "flag_size", "description": "Can be used to tweak the size of the image_flag up or down from 100px as desired. If used, 'px' must be specified; default size is 100px.", "type": "string", "required": false },   "flag_alt": { "label": "flag_alt", "description": "Alt text for the flag.", "type": "string", "required": false },   "flag_link": { "label": "flag_link", "description": "", "type": "string", "required": false },   "image_seal": { "label": "image_seal", "description": "If the place has an official seal.", "type": "string", "required": false },   "seal_size": { "label": "seal_size", "description": "If used, 'px' must be specified; default size is 100px.", "type": "string", "required": false },   "seal_alt": { "label": "seal_alt", "description": "Alt text for the seal.", "type": "string", "required": false },   "seal_link": { "label": "seal_link", "description": "", "type": "string", "required": false },   "image_shield": { "label": "image_shield", "description": "Can be used for a place with a coat of arms.", "type": "string", "required": false },   "shield_size": { "label": "shield_size", "description": "If used, 'px' must be specified; default size is 100px.", "type": "string", "required": false },

"shield_alt": { "label": "shield_alt", "description": "Alt text for the shield.", "type": "string", "required": false },

"shield_link": { "label": "shield_link", "description": "Can be used if a wiki article if known but is not automatically linked by the template. See Coquitlam, British Columbia's infobox for an example.", "type": "string", "required": false },

"image_blank_emblem": { "label": "image_blank_emblem", "description": "Can be used if a place has an official logo, crest, emblem, etc. Logo is the default type. See Kingston upon Hull's infobox for an example.", "type": "string", "required": false },

"blank_emblem_type": { "label": "blank_emblem_type", "description": "To specify what type of emblem 'image_blank_emblem' is. The default is Logo.", "type": "string", "required": false },

"blank_emblem_size": { "label": "blank_emblem_size", "description": "If used, 'px' must be specified; default size is 100px.", "type": "string", "required": false },

"blank_emblem_alt": { "label": "blank_emblem_alt", "description": "Alt text for blank emblem.", "type": "string", "required": false },

"blank_emblem_link": { "label": "blank_emblem_link", "type": "string", "required": false },

"nickname": { "label": "nickname", "description": "well-known nickname(s)", "type": "string", "required": false },

"motto": { "label": "motto", "description": "Will place the motto under the nicknames", "type": "string", "required": false },

"anthem": { "label": "anthem", "description": "Will place the anthem (song) under the nicknames", "type": "string", "required": false },

"image_map": { "label": "image_map", "description": "", "type": "string", "required": false },

"mapsize": { "label": "mapsize", "description": "If used, 'px' must be specified; default is 250px.", "type": "string", "required": false },

"map_alt": { "label": "map_alt", "description": "Alt text for map.", "type": "string", "required": false },

"map_caption": { "label": "map_caption", "type": "string", "required": false },

"image_map1": { "label": "image_map1", "description": "A secondary map image. The field 'image_map' must be filled in first. Example see: Bloomsburg, Pennsylvania.", "type": "string", "required": false },

"mapsize1": { "label": "mapsize1", "description": "If used, 'px' must be specified; default is 250px.", "type": "string", "required": false },

"map_alt1": { "label": "map_alt1", "description": "Alt text for secondary map.", "type": "string", "required": false },

"map_caption1": { "label": "map_caption1", "description": "", "type": "string", "required": false },

"image_dot_map": { "label": "image_dot_map", "description": "A field for 'manually' superimposing a dot over a blank map using an X-Y system. Blank maps, if available, can be found over at Wikimedia Commons. Example see: Rainbow Lake, Alberta", "type": "string", "required": false },

"dot_mapsize": { "label": "dot_mapsize", "description": "To change the dot map size; default is 180px ('px' is optional).", "type": "string", "required": false },

"dot_map_base_alt": { "label": "dot_map_base_alt", "description": "", "type": "string", "required": false },

"dot_map_alt": { "label": "dot_map_alt", "description": "Alt text for the dot map.", "type": "string", "required": false },

"dot_map_caption": { "label": "dot_map_caption", "description": "For placing a caption under the dot map.", "type": "string", "required": false },

"dot_x": { "label": "dot_x", "description": "For manually superimposing the dot left/right on the map.", "type": "string", "required": false },   "dot_y": { "label": "dot_y", "description": "For manually superimposing the dot up/down on the map.", "type": "string", "required": false },

"pushpin_map": { "label": "pushpin_map", "description": "The name of a location map (e.g. Indonesia or Russia). The coordinate fields (e.g. latd and longd) position a pushpin coordinate marker and label on the map 'automatically'. Example see: Padang, Indonesia", "type": "string", "required": false },

"pushpin_label_position": { "label": "pushpin_label_position", "description": "The position of the label on the pushpin map relative to the pushpin coordinate marker. Valid options are {left, right, top, bottom, none}. If this field is not specified, the default value is right.", "type": "string", "required": false },

"pushpin_map_alt": { "label": "pushpin_map_alt", "description": "Alt text for pushpin map.", "type": "string", "required": false },

"pushpin_mapsize": { "label": "pushpin_mapsize", "description": "Must be entered as only a number - do not use px. The default value is 250.", "type": "number", "required": false },

"pushpin_map_caption": { "label": "pushpin_map_caption", "description": "Fill out if a different caption from map_caption is desired.", "type": "string", "required": false },

"pushpin_relief": { "label": "pushpin_relief", "description": "Set this to 'y' or any non-blank value to use an alternative relief map provided by the selected location map (if a relief map is available).", "type": "string", "required": false },

"pushpin_map1": { "label": "pushpin_map1", "description": "Set of parameters for second pushpin map", "type": "string", "required": false },

"pushpin_label_position1": { "label": "pushpin_label_position1", "description": "", "type": "string", "required": false },

"pushpin_map_alt1": { "label": "pushpin_map_alt1", "description": "", "type": "string", "required": false },

"pushpin_mapsize1": { "label": "pushpin_mapsize1", "description": "Must be entered as only a number - do not use px.", "type": "number", "required": false },

"pushpin_map_caption1": { "label": "pushpin_map_caption1", "description": "", "type": "string", "required": false },

"pushpin_relief1": { "label": "pushpin_relief1", "description": "", "type": "string", "required": false },

"latd": { "label": "latd", "description": "Latitude degrees. Can also be used for decimal degrees.", "type": "string", "required": false },

"latm": { "label": "latm", "description": "Latitude minutes. Omit or leave blank if 'latd' has a decimal value.", "type": "string", "required": false },

"lats": { "label": "lats", "description": "Latitude seconds. Omit or leave blank if 'latd' has a decimal value.", "type": "string", "required": false },

"latNS": { "label": "latNS", "description": "Latitude North or South (enter 'N' or 'S'). Omit or leave blank if 'latd' has a decimal value.", "type": "string", "required": false },

"longd": { "label": "longd", "description": "Longitude degrees. Can also be used for decimal degrees.", "type": "string", "required": false },

"longm": { "label": "longm", "description": "Longitude minutes. Omit or leave blank if 'longd' has a decimal value.", "type": "string", "required": false },

"longs": { "label": "longs", "description": "Longitude seconds. Omit or leave blank if 'longd' has a decimal value.", "type": "string", "required": false },

"longEW": { "label": "longEW", "description": "Longitude East or West (enter 'E' or 'W'). Omit or leave blank if 'longd' has a decimal value.", "type": "string", "required": false },

"coor_pinpoint": { "label": "coor_pinpoint", "description": "If needed, to specify more exactly where (or what) coordinates are given (e.g. 'Town Hall') or a specific place in a larger area (e.g. a city in a county). Example: Masovian Voivodeship", "type": "string", "required": false }

} }