View source for Template:Infobox islands/doc

{{documentation subpage}}
{{Wikipedia text|Template:Infobox islands/doc|423019087}}
This template is intended to be used as an infobox for an [[island]] or an [[archipelago]]. For islands or archipelagos which are disputed, consider using {{tl|Infobox disputed islands}}

==Blank infobox==
{{Infobox islands
| name             = {{{name}}}
| native name      = {{{native name}}}
| sobriquet        = {{{sobriquet}}}
| image name       = {{{image name}}}
| image size       = {{{image size}}}
| image alt        = {{{image alt}}}
| image caption    = {{{image caption}}}
| locator map      = {{{locator map}}}
| locator map size = {{{locator map size}}}
| locator map alt  = {{{locator map alt}}}
| map caption      = {{{map caption}}}
| location         = {{{location}}}
| coordinates      = {{{coordinates}}}
| archipelago      = {{{archipelago}}}
| total islands    = {{{total islands}}}
| major islands    = {{{major islands}}}
| area             = {{{area km2}}} or {{{area sqmi}}} or {{{area m2}}} or {{{area sqft}}} or {{{area ha}}} or {{{area acre}}}
| rank             = {{{rank}}}
| length           = {{{length km}}} or {{{length mi}}} or {{{length m}}} or {{{length ft}}}
| width            = {{{width km}}} or {{{width mi}}} or {{{width m}}} or {{{width ft}}}
| coastline        = {{{coastline km}}} or  {{{coastline mi}}} or {{{coastline m}}} or {{{coastline ft}}}
| elevation        = {{{elevation m}}} or {{{elevation ft}}}
| highest mount    = {{{highest mount}}}
| Country heading  = {{{Country heading}}}
| country          = {{{country}}}
| country admin divisions title = {{{country admin divisions title}}}
| country admin divisions = {{{country admin divisions}}}
| country admin divisions title 1 = {{{country admin divisions title 1}}}
| country admin divisions 1 = {{{country admin divisions 1}}}
| country admin divisions title 2 = {{{country admin divisions title 2}}}
| country admin divisions 2 = {{{country admin divisions 2}}}
| country capital = {{{country capital}}}
| country largest city population = {{{country largest city population}}}
| country largest city = {{{country largest city}}}
| country leader title = {{{country leader title}}}
| country leader name = {{{country leader name}}}
| country 1       = {{{country 1}}}
| country 1 admin divisions title = {{{country 1 admin divisions title}}}
| country 1 admin divisions = {{{country 1 admin divisions}}}
| country 1 capital = {{{country 1 capital}}}
| country 1 largest city population = {{{country 1 largest city population}}}
| country 1 largest city = {{{country 1 largest city}}}
| country 1 leader title = {{{country 1 leader title}}}
| country 1 leader name = {{{country 1 leader name}}}
| country 2       = {{{country 2}}}
| country 2 admin divisions title = {{{country 2 admin divisions title}}}
| country 2 admin divisions = {{{country 2 admin divisions}}}
| country 2 capital = {{{country 2 capital}}}
| country 2 largest city population = {{{country 2 largest city population}}}
| country 2 largest city = {{{country 2 largest city}}}
| country 2 leader title = {{{country 2 leader title}}}
| country 2 leader name = {{{country 2 leader name}}}
<!-- Suppress showing 3, 4, 5, and 6 
| country 3       = {{{country 3}}}
| country 3 admin divisions title = {{{country 3 admin divisions title}}}
| country 3 admin divisions = {{{country 3 admin divisions}}}
| country 3 capital = {{{country 3 capital}}}
| country 3 largest city population = {{{country 3 largest city population}}}
| country 3 largest city = {{{country 3 largest city}}}
| country 3 leader title = {{{country 3 leader title}}}
| country 3 leader name = {{{country 3 leader name}}}
| country 4       = {{{country 4}}}
| country 4 admin divisions title = {{{country 4 admin divisions title}}}
| country 4 admin divisions = {{{country 4 admin divisions}}}
| country 4 capital = {{{country 4 capital}}}
| country 4 largest city population = {{{country 4 largest city population}}}
| country 4 largest city = {{{country 4 largest city}}}
| country 4 leader title = {{{country 4 leader title}}}
| country 4 leader name = {{{country 4 leader name}}}
| country 5       = {{{country 5}}}
| country 5 admin divisions title = {{{country 5 admin divisions title}}}
| country 5 admin divisions = {{{country 5 admin divisions}}}
| country 5 capital = {{{country 5 capital}}}
| country 5 largest city population = {{{country 5 largest city population}}}
| country 5 largest city = {{{country 5 largest city}}}
| country 5 leader title = {{{country 5 leader title}}}
| country 5 leader name = {{{country 5 leader name}}}
| country 6       = {{{country 6}}}
| country 6 admin divisions title = {{{country 6 admin divisions title}}}
| country 6 admin divisions = {{{country 6 admin divisions}}}
| country 6 capital = {{{country 6 capital}}}
| country 6 largest city population = {{{country 6 largest city population}}}
| country 6 largest city = {{{country 6 largest city}}}
| country 6 leader title = {{{country 6 leader title}}}
| country 6 leader name = {{{country 6 leader name}}}
-->
| demonym          = {{{demonym}}}
| population       = {{{population}}}
| population as of = {{{population as of}}}
| density          = {{{density km2}}} or {{{density sqmi}}}
| ethnic groups    = {{{ethnic groups}}}
| freedom rank     = {{{freedom rank}}}
| corruption rank  = {{{corruption rank}}}
| integrity score  = {{{integrity score}}}
| business rank    = {{{business rank}}}
| website          = {{{website}}}
| additional info  = {{{additional info}}}
}}
=== Metric units ===
<pre style="overflow:auto">
{{Infobox islands
| name             = 
| native name      = <!-- or local name to remove the "native name:" prefix -->
| sobriquet        = <!-- or nickname -->
| image name       = 
| image size       = 
| image caption    = 
| image alt        = 
| locator map      = 
| locator map size = 
| map caption      = 
| location         = 
| coordinates      = 
| archipelago      = 
| total islands    = 
| major islands    = 
| area km2         = <!-- or area m2 or area ha -->
| area footnotes   = 
| rank             = 
| length km        = <!-- or length m  -->
| length footnotes = 
| width km         = <!-- or width m  -->
| width footnotes  =
| coastline km     = <!-- or coastline m  -->
| coastline footnotes = 
| elevation m      = 
| elevation footnotes = 
| highest mount    = <!--name-->
| Country heading  = 
| country          = 
| country admin divisions title     = 
| country admin divisions           = 
| country admin divisions title 1   = 
| country admin divisions 1         = 
| country admin divisions title 2   = 
| country admin divisions 2         = 
| country capital                   = 
| country largest city              = 
| country largest city population   = 
| country leader title              = 
| country leader name               = 
| country 1                         = 
| country 1 admin divisions title   = 
| country 1 admin divisions         = 
| country 1 admin divisions title 1 = 
| country 1 admin divisions 1       = 
| country 1 admin divisions title 2 = 
| country 1 admin divisions 2       = 
| country 1 capital city            = 
| country 1 largest city            = 
| country 1 largest city population = 
| country 1 leader title            = 
| country 1 leader name             = 
| demonym          = 
| population       = 
| population as of = 
| density km2      = 
| density footnotes = 
| ethnic groups    = 
| freedom rank     = <!-- template available (see example below) -->
| corruption rank  = <!-- template available (see example below) -->
| integrity score  = 
| business rank    = 
| website          = 
| additional info  = 
}}
</pre>

=== Non-metric units ===
<pre style="overflow:auto">
{{Infobox islands
| name             = 
| native name      = <!-- or local name to remove the "native name:" prefix -->
| sobriquet        = <!-- or nickname -->
| image name       = 
| image size       = 
| image caption    = 
| image alt        = 
| locator map      = 
| locator map size = 
| map caption      = 
| location         = 
| coordinates      = 
| archipelago      = 
| total islands    = 
| major islands    = 
| area sqmi        = <!-- or area sqft or area acre -->
| area footnotes   = 
| rank             = 
| length mi        = <!-- or length ft -->
| length footnotes = 
| width mi         = <!-- or width ft -->
| width footnotes  = 
| coastline mi     = <!-- or coastline ft -->
| coastline footnotes = 
| elevation ft     = 
| elevation footnotes = 
| highest mount    = <!--name-->
| Country heading  = 
| country          = 
| country admin divisions title     = 
| country admin divisions           = 
| country admin divisions title 1   = 
| country admin divisions 1         = 
| country admin divisions title 2   = 
| country admin divisions 2         = 
| country capital                   = 
| country largest city              = 
| country largest city population   = 
| country leader title              = 
| country leader name               = 
| country 1                         = 
| country 1 admin divisions title   = 
| country 1 admin divisions         = 
| country 1 admin divisions title 1 = 
| country 1 admin divisions 1       = 
| country 1 admin divisions title 2 = 
| country 1 admin divisions 2       = 
| country 1 capital city            = 
| country 1 largest city            = 
| country 1 largest city population = 
| country 1 leader title            = 
| country 1 leader name             = 
| demonym          = 
| population       = 
| population as of = 
| density sqmi     = 
| density footnotes = 
| ethnic groups    = 
| freedom rank     = <!-- template available (see example below) -->
| corruption rank  = <!-- template available (see example below) -->
| integrity score  = 
| business rank    = 
| website          = 
| additional info  = 
}}
</pre>
=== Width range ===
To express a width range, replace {{para|width km}} or {{para|width m}} or {{para|width mi}} or {{para|width ft}} with one of the following:
<pre>
| width min km     =
| width max km     =
</pre>
or
<pre>
| width min m      =
| width max m      =
</pre>
or
<pre>
| width min mi     =
| width max mi     =
</pre>
or
<pre>
| width min ft     =
| width max ft     =
</pre>
{{-}}

==Example==
{{Infobox islands
| name          = Sumatra
| native name   = Pulau Sumatra
| image name    = Sumatra Volcanoes.png
| image caption = Tectonic of Sumatra
| image alt     = The island of Sumatra, oriented north-west, with a line of volcanoes along its south-western edge, and the offshore Sumatran Trench encroaching on it at a rate of 5.5 centimetres per year.
| area km2      = 470000
| location      = [[South East Asia]]
| coordinates   = {{coord|0|N|102|E|region:ID_type:isle}}
| archipelago   = [[Greater Sunda Islands]]
| country       = Indonesia
| country admin divisions title = Province
| country admin divisions       = [[Aceh]], [[North Sumatra]], [[West Sumatra]], [[Bengkulu]], [[Jambi]], [[South Sumatra]], [[Riau]], [[Lampung]]
| largest city  = [[Medan]]
| demonym       = Sumatran
| population    = More than 40 million
| density km2   = 85
| ethnic groups = [[Acehnese people|Acehnese]], [[Batak (Indonesia)|Batak]], [[Minangkabau people|Minangkabau]], [[Malay people|Malay]]
| freedom rank     = {{efindex|56|116}}
| corruption rank  = {{efindex|2.8|111}}
| integrity score  = 74
| business rank    = 121
}}
<pre style="overflow: auto">
{{Infobox islands
| name          = Sumatra
| native name   = Pulau Sumatra
| image name    = Sumatra Volcanoes.png
| image caption = Tectonic of Sumatra
| image alt     = The island of Sumatra, oriented north-west, with a line of volcanoes along its south-western edge, and the offshore Sumatran Trench encroaching on it at a rate of 5.5 centimetres per year.
| area km2      = 470000
| location      = [[South East Asia]]
| coordinates   = {{coord|0|N|102|E|region:ID_type:isle}}
| archipelago   = [[Greater Sunda Islands]]
| country       = Indonesia
| country admin divisions title = Province
| country admin divisions       = [[Aceh]], [[North Sumatra]], [[West Sumatra]], [[Bengkulu]], [[Jambi]], [[South Sumatra]], [[Riau]], [[Lampung]]
| largest city  = [[Medan]]
| demonym       = Sumatran
| population    = More than 40 million
| density km2   = 85
| ethnic groups = [[Acehnese people|Acehnese]], [[Batak (Indonesia)|Batak]], [[Minangkabau people|Minangkabau]], [[Malay people|Malay]]
| freedom rank     = {{efindex|56|116}}
| corruption rank  = {{efindex|2.8|111}}
| integrity score  = 74
| business rank    = 121
}}
</pre>
{{clear}}

==Parameters==

===Mandatory===
* '''name''' = the official name (without the word ''island'')
* '''location''' = the sea in which the island is located
* '''country''' = where the island is located. Either specify the standard three-letter [[ISO 3166-1 alpha-3]] code for the country, or a name by which the country is commonly known (''e.g.'', "US", "South Korea", "Democratic People's Republic of Korea"). As this parameter makes use of the {{tl|flag}} template, do not [[Wikipedia:Manual of Style (links)|wikilink]] the country name like this: "<tt><nowiki>[[Indonesia]]</nowiki></tt>". (See {{tl|flag}} for more information.) If the island is shared, then use "country 1" and "country 2" and list them alphabetically.

===Optional===
* '''native name''' = only when the common name is different from the native name.  To remove the "native name" prefix, use '''local name''' instead.
* '''sobriquet''' (or '''nickname''') = for a well known [[sobriquet]] or nickname
* '''image name''' = locator/satellite/other map image (without the prefix "Image:")
** '''image caption''' = caption for the image
** '''image size''' = size of the image in [[pixel]]s (''e.g.'', "<tt>100px</tt>")
** '''image alt''' = alt text for readers who cannot see the image; see [[Wikipedia:Alternative text for images]] for more information
* '''locator map''' = a locator map image (without the prefix "Image:") if there is one separate from the image used for the parameter "image name".  The image will only be linked if it exists, which allows for use of the {{tl|location map}} template.
** '''locator map size''' = size of the locator map in pixels (''e.g.'', "<tt>300px</tt>")
* '''coordinates''' = geographic coordinates: use {{tl|coord}} with the parameter "<tt>display=inline,title</tt>"
* '''archipelago''' = the name of the group of islands the island belongs to
* '''total islands''' = total number of islands (for archipelagos only)
* '''major islands''' = names of the major islands (for archipelagos only)
* '''area km2''' or '''area sqmi''' or '''area m2''' or '''area sqft''' or '''area acre''' or '''area ha''' = the area in either square kilometres or square miles or square metres or square feet or hectares or acres without using {{tl|convert}}; the conversion will be done automatically
** '''area footnotes''' = references for area values using {{tag|ref}} format.
* '''rank''' = the island's rank among other islands in the world in terms of size (1st being the largest island), as indicated in "[[List of islands by area]]"
* '''length km''' or '''length mi''' or '''length m''' or '''length ft''' = the length in either kilometres or miles or metres or feet without using {{tl|convert}}; the conversion will be done automatically
** '''length footnotes''' = references for length values using {{tag|ref}} format.
* '''width km''' or '''width mi''' or '''width m''' or '''width ft''' = the width in either kilometres or miles or metres or feet without using {{tl|convert}}; the conversion will be done automatically
** '''width footnotes''' = references for width values using {{tag|ref}} format.
* '''coastline km''' or '''coastline mi''' or '''coastline m''' or '''coastline ft''' = the length of the coastline in either kilometres or miles or metres or feet without using {{tl|convert}}; the conversion will be done automatically
** '''coastline footnotes''' = references for coastline values using {{tag|ref}} format.
* '''elevation m''' or '''elevation ft''' = the height of the highest point in either metres or feet without using {{tl|convert}}; the conversion will be done automatically
** '''elevation footnotes''' = references for elevation values using {{tag|ref}} format.
* '''highest mount''' = name of the highest point on the island, if any
* '''Country heading''' = alternative title for the Country section (defaults value is "Country")
* '''country admin divisions title''' = title for the administrative divisions
* '''country admin divisions''' = the administrative divisions that govern the island
* '''country admin divisions title 1''' = (country admin divisions title 1)
* '''country admin divisions 1''' = (country admin divisions 1)
* '''country admin divisions title 2''' = (country admin divisions title 2)
* '''country admin divisions 2''' = (country admin divisions 2)
* '''country capital'''
* '''country largest city'''
* '''country largest city population'''
* '''country leader title'''
* '''country leader name'''
* '''country 1''' = (see '''country''')
* '''country 1 admin divisions title''' = (country admin divisions title)
* '''country 1 admin divisions''' = (country admin divisions)
* '''country 1 capital city''' = (country capital city)
* '''country 1 largest city''' = (country largest city)
* '''country 1 largest city population''' = (country largest city population)
* '''country 1 leader title'''
* '''country 1 leader name'''
* '''country 2''' = (see '''country''')
* '''country 2 admin divisions title''' = (country admin divisions title)
* '''country 2 admin divisions''' = (country admin divisions)
* '''country 2 capital city''' = (country capital city)
* '''country 2 largest city''' = (country largest city)
* '''country 2 largest city population''' = (country largest city population)
* '''country 2 leader title'''
* '''country 2 leader name'''
*: ...
* '''country 6''' = (see '''country''')
* '''country 6 admin divisions title''' = (country admin divisions title)
* '''country 6 admin divisions''' = (country admin divisions)
* '''country 6 capital city''' = (country capital city)
* '''country 6 largest city''' = (country largest city)
* '''country 6 largest city population''' = (country largest city population)
* '''country 6 leader title'''
* '''country 6 leader name'''
* '''demonym''' = the name the people of the island are called that is based on location
* '''population''' = the size of the island's population
* '''population as of''' = the year when the population [[census]] took place
* '''density km2''' or '''density sqmi''' = the [[population density]] of the island expressed in either persons per square kilometres or persons per square miles without using {{tl|convert}}; the conversion will be done automatically. For example if the number is 85, the output for <code>density km2</code> is {{convert|85|PD/km2|PD/sqmi|abbr=on}}.
** '''density footnotes''' = references for density values using {{tag|ref}} format.
* '''ethnic groups''' = list the major [[ethnic group]]s making up the island's population
* '''freedom rank'''     = the score and world ranking on the [[Heritage Foundation]] [[Index of Economic Freedom]]. Using {{tl|efindex}} will give a uniform look.
* '''corruption rank'''  = the score and world ranking on the Transparency International [[Corruption Perceptions Index]]. Using {{tl|efindex}} will give a uniform look.
* '''integrity score'''  = the score given on the [[Global Integrity Report]]
* '''business rank'''    = the worldwide overall rank in ease of conducting business as rated by IFC and [[World Bank]]
* '''website''' = 
* '''additional info''' = a space for additional information at the bottom of the infobox

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

==Deprecated parameters==
Several parameters have been deprecated. Article using such parameters are listed in this [[:Category:Infobox islands using deprecated parameters|category]].



<includeonly>
[[Category:Geography infobox templates|Islands]]

</includeonly>