Template:Infobox city/doc

Infobox city is WikiPartner's standard infobox for city articles.

Use it for notable cities and city-level municipalities. Countries should use Template:Infobox country, while non-city geographic places such as regions, districts, landmarks, and other locations should normally use Template:Infobox place.

All parameters are optional. Add only information supported by reliable sources. Empty fields are automatically hidden.

Adding this template to an article also generates Schema.org City structured data automatically. Editors do not need to create schema markup manually.

Short usage

Use this version for most city articles.

{{Infobox city
| name =
| native_name =

| image =
| image_alt =
| caption =

| country =
| region =
| district =
| capital_of =

| area_total =

| population =
| population_as_of =

| elevation =
| coordinates =
| latitude =
| longitude =

| timezone =
| website =
}}

Full usage

Use this version when more verified information is available. Remove fields that are not needed.

{{Infobox city
| name =
| official_name =
| native_name =
| other_names =
| nickname =
| motto =

| type =

| image =
| image_alt =
| caption =

| map_image =
| map_alt =
| map_caption =

| country =
| region =
| district =
| capital_of =

| named_for =
| founded_by =

| established_title =
| established =
| incorporated =

| government_type =
| governing_body =

| leader_title =
| leader_name =
| leader_title2 =
| leader_name2 =

| area_total =
| area_total_km2 =
| area_land =
| area_water =
| metro_area =

| elevation =
| elevation_m =

| population =
| population_number =
| population_as_of =
| population_urban =
| population_urban_number =
| population_metro =
| population_metro_number =
| population_density =

| demonym =

| timezone =
| utc_offset =

| postal_code =
| area_code =

| coordinates =
| latitude =
| longitude =

| website =
}}

Human-readable and structured-data values

Some information has both a visible value and a machine-readable numeric value.

For population:

| population = 10,000,000
| population_number = 10000000
| population_as_of = 2026

For total area:

| area_total = 1,772 km²
| area_total_km2 = 1772

For elevation:

| elevation = 217 m
| elevation_m = 217

For coordinates:

| coordinates = 31.5497°N, 74.3436°E
| latitude = 31.5497
| longitude = 74.3436

The human-readable values appear in the infobox. The plain numeric values are used for structured data.

Do not include units, commas, references, templates, or other text inside machine-readable numeric parameters such as population_number, area_total_km2, elevation_m, latitude, or longitude.

Administrative divisions

Use:

country for the sovereign country containing the city.
region for the major first-level or similar administrative division, such as a state, province, autonomous region, or major region.
district for a smaller administrative division such as a district or county when relevant.
capital_of when the city officially serves as the capital or administrative seat of a country or major subdivision.

Do not duplicate the same administrative area in several fields.

Government and leadership

Use government_type for the form or system of municipal government.

Use governing_body for the principal municipal governing institution.

Use:

| leader_title = Mayor
| leader_name = Example Name

when the city has a relevant principal officeholder.

A second leadership field is available when a city has another important city-level office:

| leader_title2 =
| leader_name2 =

Officeholders change over time. Verify current leadership before adding it.

Population

Population figures can refer to different geographic boundaries.

Use population for the population of the city or city-level administrative area described by the article.

Use population_urban only when a reliable source clearly identifies an urban-area population.

Use population_metro only when a reliable source clearly identifies a metropolitan-area population.

Always include population_as_of for the main population figure.

Do not mix city, urban-area, and metropolitan-area population figures.

Images

Use image for the main representative city image.

Use map_image for a useful location or administrative map.

Use filenames only. Do not include File:... markup inside image parameters.

Example:

| image = Example city skyline.jpg
| image_alt = Skyline of Example City
| caption = Skyline of Example City

| map_image = Example City location map.svg
| map_alt = Map showing the location of Example City
| map_caption = Location within Example Region

Examples

The examples below omit images so the documentation does not depend on specific uploaded filenames.

Lahore

Wikitext

{{Infobox city
| name = Lahore
| native_name = لاہور
| type = City
| country = Pakistan
| region = Punjab
| district = Lahore District
| capital_of = Punjab
| coordinates = 31.5497°N, 74.3436°E
| latitude = 31.5497
| longitude = 74.3436
| timezone = Pakistan Standard Time
| utc_offset = UTC+05:00
| website = https://lahore.punjab.gov.pk/
}}

Rendered infobox

Lahore

City

Native name

لاہور

Type

City

Country

Pakistan

State / province / region

Punjab

District / county

Lahore District

Capital of

Punjab

Time zone

Pakistan Standard Time(UTC+05:00)

Coordinates

31.5497°N, 74.3436°E

Website

Official website

Paris

Wikitext

{{Infobox city
| name = Paris
| type = Capital city
| country = France
| region = Île-de-France
| capital_of = France
| website = https://www.paris.fr/
}}

Rendered infobox

Paris

Capital city

Type

Capital city

Country

France

State / province / region

Île-de-France

Capital of

France

Website

Official website

Toronto

Wikitext

{{Infobox city
| name = Toronto
| type = City
| country = Canada
| region = Ontario
| capital_of = Ontario
| website = https://www.toronto.ca/
}}

Rendered infobox

Toronto

City

Type

City

Country

Canada

State / province / region

Ontario

Capital of

Ontario

Website

Official website

Usage notes

Use name for the commonly recognized English article name.
Use official_name only when an official form differs meaningfully from the common article name.
Use native_name for the name in a relevant native language or writing system.
Use other_names for important alternate names. Separate multiple names with semicolons where practical.
Use nickname only for a well-established nickname supported by reliable sources.
Use motto only for an official or well-established municipal motto.
type defaults visually to City. Use another value such as Capital city only when it is useful and accurate.
Use named_for only when the origin of the city's name is reliably established.
Use founded_by only when reliable historical sources identify a founder or founders.
established_title can be used for labels such as Founded, Settled, or Established.
Use incorporated only when municipal incorporation is a meaningful and sourced milestone.
Verify current leadership before using leader_name or leader_name2.
Include units in visible area and elevation fields.
Use plain numbers only in numeric structured-data fields.
Always distinguish city population from urban and metropolitan populations.
Use a dated population source and include population_as_of.
Use coordinates for the human-readable coordinates displayed to readers.
Use decimal latitude and longitude for structured data.
Longitude west of Greenwich should normally use a negative value.
Use postal_code and area_code only when a concise value can accurately represent the city.
Use website for the city's official municipal or government website.
The website should normally be the final visible infobox field.
Leave unused parameters out.
Never guess administrative boundaries, population, area, coordinates, government structure, officeholders, historical dates, or other city information.
Do not confuse a city with its metropolitan area, district, county, division, province, state, or similarly named administrative unit.

Structured data

WikiPartner represents city articles using Schema.org City.

The template can automatically provide:

city name
alternate names
main image
geographic coordinates
elevation
containing country, region, and district
population
urban population
metropolitan population
total area
establishment information
government information
capital status
time zone
postal and telephone area codes
official website

Editors do not add JSON-LD manually.

TemplateData

WikiPartner's standard infobox for cities and city-level municipalities.

Template parameters
Parameter		Description	Type	Status
Name	`name`	Commonly recognized English or article name of the city.	String	optional
Official name	`official_name`	Formal official name when it differs meaningfully from the common name.	String	optional
Native name	`native_name`	City name in a relevant native language or writing system.	String	optional
Other names	`other_names`	Important alternate or historical names. Separate multiple values with semicolons where practical.	String	optional
Nickname	`nickname`	Well-established nickname of the city.	String	optional
Motto	`motto`	Official or well-established municipal motto.	String	optional
City type	`type`	Useful city classification such as City or Capital city. Default City	String	optional
Image	`image`	Main representative city image filename.	File	optional
Image alternative text	`image_alt` `alt`	Short alternative text describing the main city image.	String	optional
Image caption	`caption`	Caption displayed below the main city image.	String	optional
Map image	`map_image`	Location or administrative map filename.	File	optional
Map alternative text	`map_alt`	Short alternative text describing the city map.	String	optional
Map caption	`map_caption`	Caption displayed below the city map.	String	optional
Country	`country`	Sovereign country containing the city.	String	optional
State, province or region	`region`	Major administrative area containing the city, such as a state, province or region.	String	optional
District or county	`district`	Smaller administrative division containing the city when relevant.	String	optional
Capital of	`capital_of`	Country or major administrative division for which the city serves as the capital or administrative seat.	String	optional
Named for	`named_for`	Person, place, concept or other subject for which the city was named.	String	optional
Founded by	`founded_by`	Founder or founders when reliably established.	String	optional
Established label	`established_title`	Label for the establishment event, such as Founded, Settled or Established.	String	optional
Established	`established`	Date or year of the relevant founding, settlement or establishment event.	String	optional
Incorporated	`incorporated`	Date or year of municipal incorporation when relevant.	String	optional
Government type	`government_type`	Form or system of municipal government.	String	optional
Governing body	`governing_body`	Principal municipal governing institution.	String	optional
Leader title	`leader_title`	Official title of the principal city-level officeholder, such as Mayor.	String	optional
Leader name	`leader_name`	Current principal city-level officeholder.	String	optional
Second leader title	`leader_title2`	Official title of a second important city-level officeholder.	String	optional
Second leader name	`leader_name2`	Current second city-level officeholder when useful.	String	optional
Total area	`area_total`	Human-readable total city area including the unit.	String	optional
Total area in square kilometres	`area_total_km2`	Plain numeric total area in square kilometres for structured data.	Number	optional
Land area	`area_land`	Human-readable land area including the unit.	String	optional
Water area	`area_water`	Human-readable water area including the unit.	String	optional
Metro area	`metro_area`	Human-readable metropolitan-area size when reliably defined.	String	optional
Elevation	`elevation`	Human-readable elevation including the unit.	String	optional
Elevation in metres	`elevation_m`	Plain numeric elevation in metres for structured data.	Number	optional
Population	`population`	Human-readable city population.	String	optional
Population number	`population_number`	Plain numeric city population for structured data.	Number	optional
Population as of	`population_as_of`	Year or date applicable to the main population figure.	String	optional
Urban population	`population_urban`	Human-readable urban-area population when reliably defined.	String	optional
Urban population number	`population_urban_number`	Plain numeric urban-area population for structured data.	Number	optional
Metro population	`population_metro`	Human-readable metropolitan-area population when reliably defined.	String	optional
Metro population number	`population_metro_number`	Plain numeric metropolitan-area population for structured data.	Number	optional
Population density	`population_density`	Population density including its unit.	String	optional
Demonym	`demonym`	Common demonym for residents of the city.	String	optional
Time zone	`timezone`	Time zone used by the city.	String	optional
UTC offset	`utc_offset`	UTC offset associated with the displayed time zone.	String	optional
Postal code	`postal_code`	Postal code or concise postal-code range when appropriate.	String	optional
Area code	`area_code`	Telephone area or dialing code used by the city.	String	optional
Coordinates	`coordinates`	Human-readable geographic coordinates displayed in the infobox.	String	optional
Latitude	`latitude`	Decimal latitude for structured geographic data.	Number	optional
Longitude	`longitude`	Decimal longitude for structured geographic data.	Number	optional
Website	`website`	Official municipal or city-government website.	URL	optional