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, et cetera - in fact, any subdivision below the level of a country, for which Infobox Country should be used. Available fields are described in the table below. For questions see the talk page.

Redirects and calls
The following templates call this one: Category:Templates calling Infobox settlement

The following Infobox templates redirect here:


 * Administrative division
 * area
 * borough
 * city
 * county
 * department
 * district
 * division
 * hamlet
 * location
 * municipality
 * neighborhood
 * neighbourhood
 * parish
 * place
 * province
 * region
 * state
 * subdivision
 * territory
 * town
 * township
 * village
 * voivod

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.
 * Expression Error may also be caused when any coordinate parameter has a value, but one or more coordinate parameters are blank of 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.

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 || required if official_name missing || The usual name in English
 * - valign=top
 * official_name || required if name missing || The official name in English
 * - 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 or Metro (if urban and 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. Default size will be 250px
 * - valign=top
 * imagesize || optional || Can be used to tweak the size of the image_skyline up or down. This can can helpful if an editor want to make the infobox wider.
 * - 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. Default size:100px
 * - valign=top
 * flag_size || optional || Can be used to tweak the size of the image_flag up or down from 100px as desired.
 * - 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 || Default 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 || Default 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
 * - 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. Deprecated name =city_logo 
 * - 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 || Default is 100px. Deprecated name =citylogo_size 
 * - valign=top
 * blank_emblem_alt || optional || Alt text for blank emblem.
 * - valign=top
 * blank_emblem_link || optional || Deprecated name =logo_link 

! colspan=3 style="background: #DDDDDD;" | Nickname and Motto
 * - 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

! colspan=3 style="background: orange;" |
 * - 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 || 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 || 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.
 * - 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 (eg. Indonesia or Russia). The coordinate fields (eg. 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;no need for 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_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 ||
 * - valign=top
 * pushpin_map_caption1 || optional ||
 * - valign=top
 * latd || optional || Latitude degrees. Can also be used for decimal degrees.
 * - valign=top
 * latm || optional || Latitude minutes
 * - valign=top
 * lats || optional || Latitude seconds
 * - valign=top
 * latNS || optional || Latitude North or South (enter N or S).
 * - valign=top
 * longd || optional || Longitude degrees. Can also be used for decimal degrees.
 * - valign=top
 * longm || optional || Longitude minutes
 * - valign=top
 * longs || optional || Longitude seconds
 * - valign=top
 * longEW || optional || Longitude East or West (enter E or W).

! colspan=3 style="background: #DDDDDD;" | Coordinates display If coordinates_type is not used: If coordinates_type is needed, to specify region, type and scale in accordance with how it is done at coord, i.e.. See Birmingham or Pie Town for examples. Any value 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 Deprecated name =coor_type 
 * - valign=top
 * coordinates_type || optional
 * Can be used to override the default type and region for coordinates.
 * region will be set according to "subdivision_name", e.g. subdivision_name = United Kingdom will generate coordinates with "region:GB". For Canada and the United States, in addition, "subdivision_name1" will be used, e.g. subdivision_name = Canada and subdivision_name1 = Ontario => "region:CA-ON".
 * type is set to "type:city". If population_total is a number, it is set to type:city(population_total). If the population_total field includes text, symbols or commas, "type:city" is used instead.
 * - valign=top
 * coordinates_display || optional
 * If the field is empty or not used, the coordinates will be displayed in the infobox only.
 * - 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 , don't add flag icons or flag templates 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 . Don't add flag icons or flag templates in this field.

! 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
 * 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. For no label, can be set to &nbsp&#59; (this precise value also causes the total population to be displayed on the same line as the word Population).
 * - 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 || Area magnitude of total_area in terms of m2. Should enter 1 E+6 for area of 1.0 km2. See 1 E+6 m²
 * - valign=top
 * area_total_km2 || optional || Total area in square kilometers&mdash;symbol: km2, which is wiki-linked. Value must be entered in raw format, no commas or spaces. Auto-converted to display square miles if area_total_sq_mi is empty. Deprecated name =area_total
 * - valign=top
 * area_total_sq_mi || optional || Total area in square miles&mdash;symbol: sq mi, which is wiki-linked. Value must be entered in raw format, no commas or spaces. Auto-converted to display square kilometers if area_total_km2 is empty. Deprecated name =TotalArea_sq_mi
 * - 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 and square miles if area_total_km2 and area_total_sq_mi 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. Deprecated name =area_land
 * - 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. Deprecated name =LandArea_sq_mi
 * - 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. Deprecated name =area_water
 * - 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. Deprecated name =WaterArea_sq_mi
 * - valign=top
 * area_water_percent || optional || percent of water without the "%"
 * - valign=top
 * area_urban_km2 || optional || Deprecated name =area_urban 
 * - valign=top
 * area_urban_sq_mi || optional || Deprecated name =UrbanArea_sq_mi 
 * - valign=top
 * area_metro_km2 || optional || Deprecated name =area_metro 
 * - valign=top
 * area_metro_sq_mi || optional || Deprecated name =MetroArea_sq_mi
 * - 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_blank2_title || optional ||
 * - valign=top
 * area_blank2_km2 || optional ||
 * - valign=top
 * area_blank2_sq_mi || optional ||

! 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, the editor must enter a converted range in the elevation_ft field to over-ride the automatic conversion. use the "max" and "min" fields below Deprecated name =elevation 
 * - 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, the editor must enter a converted range in the elevation_m field to over-ride the automatic conversion. 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_footnotes || optional || Reference(s) for population, placed within tags, possibly using the citing format at Cite web
 * - valign=top
 * population_total || optional || Actual population (see below for estimates)
 * - valign=top
 * population_as_of || optional || The year for the population total (usually a census year)
 * - valign=top
 * population_density_km2 || optional || Deprecated name =population_density
 * - valign=top
 * population_density_sq_mi || optional || Deprecated name =population_density_mi2
 * - 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_footnotes || optional || Reference(s) for urban population, placed within tags
 * - valign=top
 * population_urban || optional ||
 * - valign=top
 * population_density_urban_km2 || optional ||
 * - valign=top
 * population_density_urban_sq_mi || optional || Deprecated name =population_density_urban_mi2
 * - valign=top
 * population_metro_footnotes || optional || Reference(s) for metro population, placed within tags
 * - valign=top
 * population_metro || optional ||
 * - valign=top
 * population_density_metro_km2 || optional ||
 * - valign=top
 * population_density_metro_sq_mi || optional || Deprecated name =population_density_metro_mi2
 * - 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 blank6_name_sec1 || optional || Up to 6 additional fields (7 total) can be displayed in this section
 * - valign=top
 * blank1_info_sec1 to blank6_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 blank6_name_sec2 || optional || Up to 6 additional field (7 total) can be displayed in this section
 * - valign=top
 * blank1_info_sec2 to blank6_info_sec2 || optional ||

! colspan=3 style="background: #DDDDDD;" | Website, Footnotes
 * - valign=top
 * - valign=top
 * website || optional || External link to official website, suggested format is

which prevents unnecessary display of leading http://
 * - valign=top
 * footnotes || optional || Text to be displayed at the bottom of the infobox
 * }

Example
from Detroit, Michigan -- Note Pipe characters are in front of the line of cell data, instead of at the end of the line, which simplify the spacing:



Microformat
ar:قالب:Infobox Settlement az:Şablon:Şəhər bg:Шаблон:Селище ca:Plantilla:Infotaula de municipi cs:Šablona:Infobox sídla světa da:Skabelon:Infoboks by dsb:Pśedłoga:Infokašćik Město es:Plantilla:Ficha de entidad subnacional eo:Ŝablono:Urbokadro fa:الگو:دادان شهر hsb:Předłoha:Město lv:Veidne:Infobox Settlement hu:Sablon:Infobox város ia:Patrono:Infobox Settlement mk:Шаблон:Инфокутија Град mr:साचा:माहितीचौकट शहर ja:Template:Infobox City ka:თარგი:ინფოდაფა დასახლება ko:틀:도시 정보 nl:Sjabloon:Infobox plaats no:Mal:Infoboks by pt:Predefinição:Infobox Assentamento ro:Format:Infobox Localitate ru:Шаблон:НП simple:Template:Infobox City sl:Predloga:Infopolje Naselje fi:Malline:Kaupunki2 sv:Mall:Stadsfakta th:แม่แบบ:กล่องข้อมูล เมือง tr:Şablon:Kent bilgi kutusu uk:Шаблон:Картка:Місто vi:Tiêu bản:Tóm tắt về thành phố zh:Template:Infobox Settlement