استعرض مصدر قالب:Infobox Settlement/doc

{{documentation subpage}}

{{warning|<big>'''Before making any changes to the template'''</big>, please first compare your changes in the test template: [[قالب:Infobox settlement/sandbox]]. Thank you.}}
{{intricate template}}

This template can be used to produce an [[WP:Infobox|Infobox]] for human settlements (cities, towns, villages, communities) as well as other administrative districts, counties, provinces, etc. - in fact, any subdivision below the level of a country, for which {{tl|Infobox Country}} should be used.  Available fields are described in the table below. 

== Usage ==

'''Please verify that adding the template does not overlay, or get overlaid by, other templates on the article. Please test your changes with several skins and several browsers, and several browser window sizes.'''

<div style="padding:7pt;margin:1px"> 
* '''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 parametes are blank of invalid.
</div>
<br />

=== Complete Empty Syntax ===
For questions see the [[نقاش القالب:Infobox settlement|talk page]].

<pre>
{{Infobox settlement
<!-- See Template:Infobox settlement for additional fields that may be available -->
<!-- See the Table at Infobox settlement for all fields and descriptions of usage -->
<!-- Basic info ---------------->
|name                   = <!-- at least one of the first two fields must be filled in -->
|official_name          = 
|other_name             =
|native_name            = <!-- if different from the English name -->
|native_name_lang       = <!-- Use ISO639 code, e.g. "fr" for French.
                               If there is more than one native name, in different languages,
                               enter those names using {{lang}}, instead -->
|nickname               = 
|settlement_type        = <!--such as Town, Village, City, Borough etc.-->
|total_type             = <!-- to set a non-standard label for total area and population rows -->
|motto                  =
<!-- Transliteration ----------->
|translit_lang1         = 
|translit_lang1_type    =
|translit_lang1_info    =
|translit_lang1_type1   =
|translit_lang1_info1   =
|translit_lang1_type2   =
|translit_lang1_info2   =
|translit_lang1_type3   =
|translit_lang1_info3   =
|translit_lang1_type4   =
|translit_lang1_info4   =
|translit_lang1_type5   =
|translit_lang1_info5   =	
|translit_lang1_type6   =
|translit_lang1_info6   =
|translit_lang2         =
|translit_lang2_type    =
|translit_lang2_info    =
|translit_lang2_type1   =
|translit_lang2_info1   =
|translit_lang2_type2   =
|translit_lang2_info2   =
|translit_lang2_type3   =
|translit_lang2_info3   =
|translit_lang2_type4   =
|translit_lang2_info4   =
|translit_lang2_type5   =
|translit_lang2_info5   =
|translit_lang2_type6   =
|translit_lang2_info6   =
<!-- Images and maps ----------->
|image_skyline          = 
|imagesize              = 
|image_caption          = 
|image_flag             = 
|flag_size              =
|image_seal             = 
|seal_size              =
|image_shield           = 
|shield_size            =
|image_blank_emblem     =
|blank_emblem_type      =
|blank_emblem_size      =
|image_map              = 
|mapsize                = 
|map_caption            = 
|image_map1             = 
|mapsize1               = 
|map_caption1           = 
|image_dot_map          =
|dot_mapsize            =
|dot_map_caption        =
|dot_x =  |dot_y =
|pushpin_map            = <!-- name of a location map as per Template:Location_map -->
|pushpin_label_position = <!-- position of the pushpin label: left, right, top, bottom, none -->
|pushpin_map_caption    =
|pushpin_mapsize        =
<!-- Location ------------------>
|subdivision_type       = <!--البلد-->
|subdivision_name       = <!--اسم البلد-->
|subdivision_type1      = 
|subdivision_name1      = 
|subdivision_type2      = 
|subdivision_name2      = 
|subdivision_type3      = 
|subdivision_name3      = 
|subdivision_type4      = 
|subdivision_name4      =
<!-- Smaller parts (e.g. boroughs of a city) and seat of government -->
|seat_type              =
|seat                   =
|parts_type             =
|parts_style            = <!-- list, coll (collapsed list), para (paragraph format)
                               Default is list if up to 5 items, coll if more than 5-->
|parts                  = <!-- parts text, or header for parts list -->
|p1                     =
|p2                     = <!-- etc. up to p50: for separate parts to be listed--> 
<!-- Politics ----------------->
|government_footnotes   =
|government_type        =
|leader_party           = 
|leader_title           =
|leader_name            =  <!--add &amp;nbsp; (no-break space) to leader names to disable automatic links-->
|leader_title1          =  
|leader_name1           =
|leader_title2          =
|leader_name2           =
|leader_title3          =
|leader_name3           =
|leader_title4          =
|leader_name4           =
|established_title      = <!-- Settled -->
|established_date       = 
|established_title1     = <!-- Incorporated (town) -->
|established_date1      = 
|established_title2     = <!-- Incorporated (city) --> 
|established_date2      = 
|established_title3     =  
|established_date3      =
|extinct_title          =
|extinct_date           =
|founder                =
|named_for              =
<!-- Area    --------------------->
|area_magnitude         = <!-- use only to set a special wikilink --> 
|unit_pref              = <!--Enter: Imperial, to display imperial before metric-->
|area_footnotes         =
|area_total_km2         = <!-- ALL fields with measurements are subject to automatic unit conversion-->
|area_land_km2          = <!--See table @ Template:Infobox settlement for details on unit conversion-->
|area_water_km2         =
|area_total_dunam       = <!--Used in Middle East articles only-->
|area_total_sq_mi       =
|area_land_sq_mi        =
|area_water_sq_mi       =
|area_water_percent     =
|area_urban_km2         =
|area_urban_sq_mi       =
|area_metro_km2         =
|area_metro_sq_mi       =
|area_blank1_title      =
|area_blank1_km2        =
|area_blank1_sq_mi      =
<!-- Elevation -------------------------->
|elevation_footnotes    =  <!--for references: use <ref> tags-->
|elevation_max_footnotes=  <!--for references: use <ref> tags-->
|elevation_min_footnotes=  <!--for references: use <ref> tags-->
|elevation_m            = 
|elevation_ft           =
|elevation_max_m        = 
|elevation_max_ft       =
|elevation_min_m        = 
|elevation_min_ft       =
<!-- Population   ----------------------->
|population_as_of               =
|population_footnotes           =
|population_note                =
|population_total               =
|population_density_km2         = <!--For automatic calculation, any density field may contain: auto -->
|population_density_sq_mi       =
|population_est                 =
|pop_est_as_of                  =
|population_metro               =
|population_density_metro_km2   =
|population_density_metro_sq_mi =
|population_urban               =
|population_density_urban_km2   =
|population_density_urban_sq_mi =
|population_blank1_title        =
|population_blank1              =
|population_density_blank1_km2  =   
|population_density_blank1_sq_mi=
|demographics_type1             =
|demographics1_footnotes        =
|demographics1_title1           =
|demographics1_info1            =
|demographics1_title2           =
|demographics1_info2            =
|demographics1_title3           =
|demographics1_info3            =
|demographics1_title4           =
|demographics1_info4            =
|demographics1_title5           =
|demographics1_info5            =
|demographics_type2             =
|demographics2_footnotes        =
|demographics2_title1           =
|demographics2_info1            =
|demographics2_title2           =
|demographics2_info2            =
|demographics2_title3           =
|demographics2_info3            =
|demographics2_title4           =
|demographics2_info4            =
|demographics2_title5           =
|demographics2_info5            =
<!-- General information  --------------->
|timezone1              = 
|utc_offset1            = 
|timezone1_DST          = 
|utc_offset1_DST        = 
|coor_pinpoint          = <!-- can be used to specify exactly where/what the coordinates refer to -->
|coordinates_type       = 
|coordinates_display    = display=inline,title <!-- delete unwanted option, if any -->
|latd= |latm= |lats= |latNS=
|longd= |longm= |longs= |longEW=
<!-- Area/postal codes & others -------->
|postal_code_type       =  <!-- enter ZIP code, Postcode, Post code, Postal code... -->
|postal_code            =
|postal2_code_type      =  <!-- enter ZIP code, Postcode, Post code, Postal code... -->
|postal2_code           =
|area_code_type         =
|area_code              =
|توأم1                  =
|توأم1_البلد            =
|توأم2                  =
|توأم2_البلد            =
|توأم3                  =
|توأم3_البلد            =
|توأم4                  =
|توأم4_البلد            =
|توأم5                  =
|توأم5_البلد            =
|توأم6                  =
|توأم6_البلد            =
|توأم7                  =
|توأم7_البلد            =
|blank_name_sec1        =
|blank_info_sec1        =
|blank1_name_sec1       =
|blank1_info_sec1       =
|blank2_name_sec1       =
|blank2_info_sec1       =
|blank3_name_sec1       =
|blank3_info_sec1       =
|blank4_name_sec1       =
|blank4_info_sec1       =
|blank5_name_sec1       =
|blank5_info_sec1       =
|blank6_name_sec1       =
|blank6_info_sec1       =
|blank_name_sec2        = 
|blank_info_sec2        =
|blank1_name_sec2       = 
|blank1_info_sec2       =
|blank2_name_sec2       = 
|blank2_info_sec2       =
|blank3_name_sec2       = 
|blank3_info_sec2       =
|blank4_name_sec2       = 
|blank4_info_sec2       =
|blank5_name_sec2       = 
|blank5_info_sec2       =
|blank6_name_sec2       = 
|blank6_info_sec2       =
|website                = 
|footnotes              = 
}} 
</pre>

=== Basic Empty Syntax ===
For questions see the [[نقاش القالب:Infobox settlement|talk page]].</big>

<pre>
{{Infobox settlement
<!--See Template:Infobox settlement for additional fields that may be available-->
<!--See the Table at Infobox settlement for all fields and descriptions of usage-->
<!-- Basic info  ---------------->
|name                   = <!-- at least one of the first two fields must be filled in -->
|nickname               = 
|settlement_type        = <!-- e.g. Town, Village, City, etc.-->
|total_type             = <!-- to set a non-standard label for total area and population rows -->
|motto                  =
<!-- images and maps  ----------->
|image_skyline          = 
|imagesize              = 
|image_caption          = 
|image_flag             = 
|flag_size              =
|image_seal             = 
|seal_size              =
|image_shield           = 
|shield_size            =
|image_blank_emblem     =
|blank_emblem_type      =
|blank_emblem_size      =
|image_map              = 
|mapsize                = 
|map_caption            = 
|image_map1             = 
|mapsize1               = 
|map_caption1           = 
|image_dot_map          =
|dot_mapsize            =
|dot_map_caption        =
|dot_x =  |dot_y =
|pushpin_map            = <!-- the name of a location map as per http://en.wikipedia.org/wiki/Template:Location_map -->
|pushpin_label_position = <!-- the position of the pushpin label: left, right, top, bottom, none -->
|pushpin_map_caption    =
|pushpin_mapsize        =
<!-- Location ------------------>
|subdivision_type       = <!--البلد-->
|subdivision_name       = <!--the name of the البلد-->
|subdivision_type1      = 
|subdivision_name1      = 
|subdivision_type2      = 
|subdivision_name2      = 
<!-- Politics ----------------->
|government_footnotes   =
|government_type        =
|leader_title           =
|leader_name            =  <!--add &nbsp; (no-break space) to leader names to disable automatic links-->
|leader_title1          =  
|leader_name1           =
|established_title      =  <!-- Settled -->
|established_date       = 
<!-- Area    --------------------->
|area_magnitude         = 
|unit_pref              = <!--Enter: Imperial, to display imperial  before metric-->
|area_footnotes         =
|area_total_km2         = <!-- ALL fields with measurements are subject to automatic unit conversion-->
|area_land_km2          = <!--See table @ Template:Infobox settlement for details on unit conversion-->
|area_water_km2         =
|area_total_sq_mi       =
|area_land_sq_mi        =
|area_water_sq_mi       =
|area_water_percent     =
<!-- Elevation -------------------------->
|elevation_footnotes    =  <!--for references: use <ref> tags-->
|elevation_m            = 
|elevation_ft           =
<!-- Population   ----------------------->
|population_as_of       =
|population_footnotes   =
|population_note        =
|population_total       =
|population_est         =
|pop_est_as_of          =
|population_density_km2 = <!--For automatic calculation, any density field may contain: auto -->
|population_density_sq_mi =
<!-- General information  --------------->
|timezone1              = 
|utc_offset1            = 
|timezone1_DST          = 
|utc_offset1_DST        = 
|latd= |latm= |lats= |latNS=
|longd= |longm= |longs= |longEW=
<!-- Area/postal codes & others -------->
|postal_code_type       =  <!-- enter ZIP code, Postcode, Post code, Postal code... -->
|postal_code            =
|area_code              =
|website                = 
|footnotes              = 
}} 
</pre>

=== Table ===
{| class="wikitable" style="background: white"
! colspan=3 style="background: orange;" |
==== Name and motto ====
|- style="background: whitesmoke;" 
! Field Name
! Usage
! Description
|- 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
| '''other_name''' || optional || For places with a former or more common name like Bombay or Saigon
|- valign=top
| '''native_name''' || optional ||This will display under the name/official name
|-
| '''native_name_lang''' || optional ||Use [http://en.wikipedia.org/wiki/List of ISO 639-2 codes|ISO 639-2] code, e.g. "fr" for French. If there is more than one native name, in different languages, enter those names using {{tl|lang}}, instead.
|-
|'''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 '''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).
|-
|'''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; (this precise value also causes the total population to be displayed on the same line as the word '''Population''').
|-
| '''nickname''' || optional || well-known nickname(s)
|-
| '''motto''' || optional ||Will place the motto under the nicknames 
|-
| '''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.     
|-
| '''translit_lang1_type''' || optional ||  
|-
| '''translit_lang1_info''' || optional ||     
|-
| '''translit_lang2''' || optional ||Will place a second transliteration.  See [[Dêlêg]]
|-
| '''translit_lang2_type''' || optional ||  
|-
| '''translit_lang2_info''' || optional ||     
|-
! colspan=3 style="background: orange;" |

==== Images and maps ====
|-
| colspan=3 | These variables are only used for generating categories for this article
|- style="background: whitesmoke;" 
! Field Name
! Usage
! Description
|- 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_caption''' || optional || Will place a caption under the image_skyline (if present)
|- 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.
|-
|'''flag_link ''' || optional || 
|-
|'''image_seal''' || optional ||If the place has an official seal.
|-
|'''seal_link ''' || optional || 
|-
|'''seal_size''' || optional ||Default is 100px.
|- valign=top
|'''image_shield ''' || optional || Can be used for a place with a coat of arms.
|- 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.
|-
|'''shield_size''' || optional ||Default is 100px.
|- 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.</br><font color=red>Deprecated name ='''city_logo ''' </font>
|- 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.  <font color=red>Deprecated name ='''citylogo_size ''' </font>
|- valign=top
|'''blank_emblem_link ''' || optional ||<font color=red>Deprecated name ='''logo_link ''' </font>
|-
|'''image_map''' || optional ||
|-
|'''mapsize''' || optional ||Default is 250px.
|-
|'''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]].
|-
|'''mapsize1''' || optional ||Default is 250px.
|-
|'''map_caption1''' || optional ||
|- 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 [http://commons.wikimedia.org/wiki/Main_Page 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_caption''' || optional || For placing a caption under the dot map.
|- valign=top
|'''dot_x </br>dot_y''' || optional ||For manually superimposing the dot left/right and up/down on the map.
|- valign=top
|'''pushpin_map''' || optional ||The name of a location map as per [[قالب: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_mapsize''' || optional ||Must be entered as only a number—'''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.
|-
! colspan=3 style="background: orange;" |
==== Location, subdivisions, government and established information ====
|- style="background: whitesmoke;" 
! Field Name
! Usage
! Description
|-
|'''subdivision_type''' || optional || almost always "Country"
|-
|'''subdivision_name''' || optional || Depends on the subdivision_type - use the name in text form, sample: <tt>United States</tt> or <tt><nowiki>[[United States]]</nowiki></tt>, don't add flag icons or flag templates in this field.
|- valign=top
|'''subdivision_type1</br>to</br>subdivision_type4''' || optional ||Can be State/Province, region, county.
|- valign=top
|'''subdivision_name1</br>to</br>subdivision_name4''' || optional || Use the name in text form, sample: <tt>Florida</tt> or <tt><nowiki>[[Florida]]</nowiki></tt>. Don't add flag icons or flag templates in this field.
|- valign=top
|'''seat_type''' || optional ||The label for the seat of government (defaults to ''Seat'').
|-
|'''seat''' || optional ||The seat of government.
|- 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, etc.''' || optional ||(maximum '''p50''') The smaller subdivisions to be listed. Example: [[Warsaw]]
|- valign=top
|'''government_footnotes''' || optional ||If a reference(s) is available this where to put them using the <nowiki><ref> </ref></nowiki> tags and possibly the citing format at {{tl|Cite web}} within the ref tags. 
|-
|'''government_type''' || optional || Example: 
|-
|'''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 || Tip: Names are automatically wiki-linked if an article exists; if the target is not the intended one, insert a character such as "&amp;nbsp;" to disable the link
|- valign=top
|'''leader_title1</br>to</br>leader_title4''' || optional ||
|- valign=top
|'''leader_name1</br>to</br>leader_name4''' || optional || For long lists use {{tl|Collapsible list}}.  See [[Halifax Regional Municipality|Halifax]] for an example.
|-
|'''established_title''' || optional || Example: First settled
|-
|'''established_date ''' || optional ||
|-
|'''established_title1 ''' || optional ||Example: Incorporated (town) 
|-
|'''established_date1''' || optional ||
|-
|'''established_title2 ''' || optional ||Example: Incorporated (city) 
|-
|'''established_date2''' || optional ||
|-
|'''established_title3 ''' || optional ||
|-
|'''established_date3''' || optional ||
|-
|'''extinct_title ''' || optional || For when a settlement ceases to exist
|-
|'''extinct_date''' || optional ||
|-
|'''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: orange;" |

==== Geographic information ====
|-
| 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;" 
! Field Name
! Usage
! Description
|- 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.<br />For the middle east, a unit preference of [[dunam]] can be entered (only affects total area). <br /> All values must be entered in a '''raw format: no commas, spaces, or unit symbols'''.  The template will format them automatically.
|- valign=top
|'''area_footnotes''' || optional ||If reference(s) are available, this is where to put them, possibly using a citing format such as {{tl|Cite web}}, within <nowiki><ref> </ref></nowiki> tags. 
|- valign=top
|'''area_magnitude''' || optional || Area magnitude of total_area in terms of m<sup>2</sup>. Should enter 1 E+6 for area of 1.0 km<sup>2</sup>.  See [[1 E+6 m²]]
|- 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_total_km2''' || optional || Total area in square kilometers—symbol: km<sup>2</sup>, 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. </br><font color=red>Deprecated name ='''area_total ''' </font>
|- valign=top
|'''area_land_km2''' || optional || Land area in square kilometers—symbol: km<sup>2</sup>. Value must be entered in '''raw format''', no comms or spaces. Auto-converted to display square miles if area_land_sq_mi is empty. </br><font color=red>Deprecated name ='''area_land''' </font>
|- valign=top
|'''area_water_km2''' || optional ||Water area in square kilometers—symbol: km<sup>2</sup>. Value must be entered in '''raw format''', no comms or spaces. Auto-converted to display square miles if area_water_sq_mi is empty. </br><font color=red>Deprecated name ='''area_water''' </font>
|- valign=top
|'''area_total_sq_mi''' || optional ||Total area in square miles—symbol: sq&nbsp;mi, which is wiki-linked. Value must be entered in '''raw format''', no comms or spaces. Auto-converted to display square kilometers if area_total_km2 is empty. </br><font color=red>Deprecated name ='''TotalArea_sq_mi''' </font>
|- valign=top
|'''area_land_sq_mi ''' || optional ||Land area in square miles—symbol: sq&nbsp;mi. Value must be entered in '''raw format''', no comms or spaces. Auto-converted to display square kilometers if area_land_km2 is empty. </br><font color=red>Deprecated name ='''LandArea_sq_mi ''' </font>
|- valign=top
|'''area_water_sq_mi''' || optional ||Water area in square miles—symbol: sq&nbsp;mi. Value must be entered in '''raw format''', no comms or spaces. Auto-converted to display square kilometers if area_water_km2 is empty. </br><font color=red>Deprecated name ='''WaterArea_sq_mi ''' </font>
|-
|'''area_water_percent''' || optional || percent of water without the "%"
|-
|'''area_urban_km2''' || optional || <font color=red>Deprecated name ='''area_urban '''</font>
|-
|'''area_urban_sq_mi''' || optional || <font color=red>Deprecated name ='''UrbanArea_sq_mi ''' </font>
|-
|'''area_metro_km2 ''' || optional || <font color=red>Deprecated name ='''area_metro ''' </font>
|-
|'''area_metro_sq_mi''' || optional || <font color=red>Deprecated name ='''MetroArea_sq_mi'''</font>
|-
|'''area_blank1_title''' || optional || Example see [[London]]
|-
|'''area_blank1_km2''' || optional ||
|-
|'''area_blank1_sq_mi''' || optional ||
|-
|'''area_blank2_title''' || optional ||
|-
|'''area_blank2_km2''' || optional ||
|-
|'''area_blank2_sq_mi''' || optional ||
|-
|'''elevation_footnotes''' || optional ||If reference(s) are available, this is where to put them, possibly using a citing format such as {{tl|Cite web}}, within <nowiki><ref> </ref></nowiki> tags.
|- valign=top
|'''elevation_max_footnotes''' || optional ||Same as above, but for the "max" elevation. See [[Leeds]]
|- valign=top
|'''elevation_min_footnotes''' || optional ||
|- 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, <s>the editor must enter a converted range in the '''elevation_m''' field to over-ride the automatic conversion.</s> use the "max" and "min" fields below </br><font color=red>Deprecated name ='''elevation ''' </font>
|- 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, <s>the editor must enter a converted range in the '''elevation_m''' field to over-ride the automatic conversion.</s> use the "max" and "min" fields below
|- valign=top
|'''elevation_max_m, elevation_max_ft, elevation_min_m, elevation_min_ft'''|| optional ||Used to give highest and/or lowest elevations, if available, instead of just a single value. Example: [[Halifax Regional Municipality]]
|- 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]]<font color=red>  Deprecated name ='''coor_type ''' </font>
|-
|'''coordinates_type''' || optional 
| Can be used to override the default [[WP:GEO#type:T|type]] and [[WP:GEO#region:R|region]] for coordinates. 

If coordinates_type is not used:
* [[WP:GEO#region:R|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".
* [[WP:GEO#type:T|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.

If coordinates_type is needed, to specify region, type and scale in accordance with how it is done at {{tl|coord}}, ''i.e.'' <code><nowiki>|coordinates_type  =region:GB_type:city_scale:1000</nowiki></code>.  See [[Birmingham]] or [[Pie Town, New Mexico|Pie Town]] for examples.
|-
|'''coordinates_display''' || optional 

| If the field is empty or not used, the coordinates will be displayed in the infobox only. 

Any value will have the coordinates displayed in the article's title as well. 

Infobox settlement uses {{Tl|Geobox coor}} to call {{Tl|Coord}} with the parameter "display=inline,title".
|-
|'''latd''' || optional ||Latitude degrees.  Can also be used for decimal degrees.
|-
|'''latm ''' || optional ||Latitude minutes
|-
|'''lats''' || optional ||Latitude seconds
|-
|'''latNS''' || optional ||Latitude North or South (enter '''N''' or '''S''').
|-
|'''longd''' || optional ||Longitude degrees.  Can also be used for decimal degrees.
|-
|'''longm''' || optional ||Longitude minutes
|-
|'''longs''' || optional ||Longitude seconds
|-
|'''longEW''' || optional ||Longitude East or West (enter '''E''' or  '''W''').
|-
! colspan=3 style="background: orange;" |

==== Population information ====
|-
| 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;" 
! Field Name
! Usage
! Description
|-
|'''population_as_of ''' || optional ||
|- valign=top
|'''population_footnotes''' || optional ||If reference(s) are available, this is where to put them, possibly using a citing format such as {{tl|Cite web}}, within <nowiki><ref> </ref></nowiki> tags.
|-
|'''population_total''' || optional ||
|- valign=top
|'''population_density_km2''' || optional || <font color=red>Deprecated name ='''population_density'''</font>
|- valign=top
|'''population_density_sq_mi''' || optional || <font color=red>Deprecated name ='''population_density_mi2''' </font>
|-
|'''population_est''' || optional || Population estimate.
|-
|'''pop_est_as_of''' || optional || The year or month & year of the population estimate. 
|-
|'''population_metro''' || optional ||
|-
|'''population_density_metro_km2''' || optional ||
|-
|'''population_density_metro_sq_mi''' || optional || <font color=red>Deprecated name ='''population_density_metro_mi2''' </font>
|-
|'''population_urban ''' || optional ||
|-
|'''population_density_urban_km2''' || optional ||
|-
|'''population_density_urban_sq_mi''' || optional || <font color=red>Deprecated name ='''population_density_urban_mi2''' </font>
|-
|'''population_blank1_title''' || optional || Can be used for estimates. Example: [[Windsor, Ontario]] 
|-
|'''population_blank1''' || optional || The population value for blank1_title
|-
|'''population_density_blank1_km2''' || optional ||
|-
|'''population_density_blank1_sq_mi''' || optional ||
|-
|'''population_blank2_title''' || optional ||
|-
|'''population_blank2''' || optional ||
|-
|'''population_density_blank2_km2''' || optional ||
|-
|'''population_density_blank2_sq_mi''' || optional ||
|- valign=top
|'''population_demonym''' || <font color=red>Not currently available</font> || 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 [[Liverpudlian]]s.
|- valign=top
|'''population_note''' || optional ||A place for additional information such as the name of the source.  See [[Windsor, Ontario]] for example.
|-
|'''demographics_type1''' || optional || Section Header.  For example: Ethnicity
|-
|'''demographics1_footnotes''' || optional ||If reference(s) are available for the first demographics section, this is where to put them, possibly using a citing format such as {{tl|Cite web}}, within <nowiki><ref> </ref></nowiki> tags
|-
|'''demographics1_title1<br />to<br />demographics1_title5''' || optional || Titles related to demographics_type1.  For example: White, Black, Hispanic...
|-
|'''demographics1_info1<br />to<br />demographics1_info5''' || optional || Information related to the "titles".  For example: 50%, 25%, 10%...
|-
|'''demographics_type2''' || optional || A second section header.  For example: Languages
|-
|'''demographics2_footnotes''' || optional ||If reference(s) are available for the second demographics section, this is where to put them, possibly using a citing format such as {{tl|Cite web}}, within <nowiki><ref> </ref></nowiki> tags
|-
|'''demographics2_title1<br />to<br />demographics2_title5''' || optional || Titles related to '''demographics_type2'''.  For example: English, French, Arabic...
|-
|'''demographics2_info1<br />to<br />demographics2_info5''' || optional || Information related to the "titles" for type2.  For example: 50%, 25%, 10%...
|-
! colspan=3 style="background: orange;" |

==== Other information ====
|- style="background: whitesmoke;" 
! Field Name
! Usage
! Description
|-
|'''timezone1''' || optional ||
|-
|'''utc_offset1''' || optional ||
|-
|'''timezone1_DST''' || optional ||
|-
|'''utc_offset1_DST''' || optional ||
|-
|'''timezone2''' || optional || A second timezone field for larger areas such as a Province.  
|-
|'''utc_offset2''' || optional ||
|-
|'''timezone2_DST''' || optional ||
|-
|'''utc_offset2_DST''' || optional ||
|-
|'''postal_code_type''' || optional ||
|-
|'''postal_code''' || optional ||
|-
|'''postal_code2_type''' || optional ||
|-
|'''postal_code2''' || optional ||
|-
|'''area_code_type''' || optional || If left blank/not used template will default to "[[Telephone numbering plan|Area code(s)]]"
|-
|'''area_code''' || optional ||
|-
|'''blank_name_sec1''' || optional ||Can be used for additional information such as car plates
|- valign=top
|'''blank_info_sec1''' || optional || This is where the information for the ''blank_name'' would go.  Example see: [[Warsaw]].
|- valign=top
|'''blank1_name_sec1<br />to<br />blank6_name_sec1''' || optional || 
|- valign=top
|'''blank1_info_sec1<br />to<br />blank6_info_sec1''' || optional ||
|- 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<br />to<br />blank_name_sec2''' || optional || 
|- valign=top
|'''blank1_info_sec2<br />to<br />blank6_info_sec2''' || optional ||
|- valign=top
|'''توأم1<br />to<br />توأم7''' || optional || Name of a twin city
|-
|'''توأم1_البلد<br />to<br />twin7_البلد''' || optional || Country of the twin city
|-
|'''footnotes''' || optional ||
|-
|'''website''' || optional ||
<!--|-
|'''Field Name''' || optional ||-->
|}
<!-- Gray table ends -->

=== Microformat ===
{{UF-hcard-geo}}

== Usage 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:

<pre>
{{Infobox settlement
|official_name = City of Detroit
|nickname = Motor City, Motown, Rock City, The D
|motto = "Speramus Meliora; Resurget Cineribus"<br />([[Latin]] for, "We Hope For Better Things; It Shall Rise From the Ashes")
|image_skyline = DetroitSkyline.jpg
|image_flag = Detroit flag.png
|image_seal = Detroit Seal.png
|image_map = Wayne County Michigan Incorporated and Unincorporated areas Detroit highlighted.svg
|map_caption = Location in [[Wayne County, Michigan|Wayne County]], [[Michigan]]
|subdivision_type = [[Countries of the world|البلد]]
|subdivision_type1 = [[U.S. state|State]]
|subdivision_type2 = [[List of counties in Michigan|County]]
|subdivision_name = [[United States]]
|subdivision_name1 = [[Michigan]]
|subdivision_name2 = [[Wayne County, Michigan|Wayne County]]
|established_title = Founded
|established_date = [[1701]]
|established_title2 = Incorporation
|established_date2 = [[1806]]
|government_type = [[Mayor-council government|Strong Mayor-Council]]
|leader_title = [[List of mayors of Detroit, Michigan|Mayor]]
|leader_name = [[Kwame Kilpatrick]] (D)
|area_magnitude = 1 E8
|area_total_sq_mi = 143.0
|area_total_km2 = 370.2
|area_land_sq_mi = 138.8
|area_land_km2 = 359.4
|area_water_sq_mi = 4.2
|area_water_km2 = 10.8
|area_urban_sq_mi = 1295
|area_urban_km2 = 3354
|area_metro_km2 = 10135
|area_metro_sq_mi = 3913
|population_as_of = 2006
|population_footnotes = <ref>{{cite web
                         | url  = http://www.census.gov/popest/estimates.php
                         | title= US Census July 1, 2006 est}}</ref>
|population_total = 871121
|population_urban = 3903377
|population_metro = 4468966
|population_density_sq_mi = 6856
|population_density_km2 = 2647
|timezone = [[Eastern Time Zone (North America)|EST]]
|utc_offset = -5
|timezone_DST = [[Eastern Daylight Time|EDT]]
|utc_offset_DST = -4
|latd = 42 | latm = 19 | lats = 53.76 | latNS = N
|longd = 83 | longm = 2 | longs = 51 | longEW = W 
|coordinates_display = X
|elevation_footnotes = <ref name=elevation>{{cite web
                                      | url  ={{Gnis3|1617959}}
                                      | title=USGS detail on Detroit
                                      | accessdate=2007-02-18 }}</ref>
|elevation_ft = 600
|elevation_m = 183
|website = http://www.detroitmi.gov
|footnotes =
}}</pre>
<includeonly>
<!-- Add Cats below-->
{{DEFAULTSORT:Infobox settlement/doc}}
[[تصنيف:City infobox templates|Settlement]]
[[تصنيف:Templates generating hCards]]
[[تصنيف:Geography infobox templates|{{PAGENAME}}]]

<!-- Add interwikis below-->
[[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]]
[[en:Template:Infobox settlement]]
[[eo:Ŝablono:Urbokadro]]
[[es:Plantilla:Ficha de entidad subnacional]]
[[fa:الگو:دادان شهر]]
[[fi:Malline:Kaupunki2]]
[[hsb:Předłoha:Město]]
[[ia:Patrono:Infobox Settlement]]
[[ja:Template:Infobox City]]
[[ka:თარგი:ინფოდაფა დასახლება]]
[[ko:틀:도시 정보]]
[[lv:Veidne:Infobox Settlement]]
[[mk:Шаблон:Инфокутија Населено место]]
[[nl:Sjabloon:Infobox plaats]]
[[no:Mal:Infoboks by]]
[[pt:Predefinição:Info/Assentamento]]
[[ru:Шаблон:НП]]
[[simple:Template:Infobox City]]
[[sl:Predloga:Infopolje Naselje]]
[[sv:Mall:Ortsfakta]]
[[th:แม่แบบ:กล่องข้อมูล เมือง]]
[[tr:Şablon:İlçe bilgi kutusu]]
[[uk:Шаблон:Картка:Місто]]
[[vi:Bản mẫu:Tóm tắt về thành phố]]
[[zh:Template:Infobox Settlement]]
</includeonly>