Template:Commons/doc

For other uses in Wikipedia, see Wikipedia:COMMON (disambiguation).

Not to be confused with Template:Copy to Wikimedia Commons.

This template is part of Wikipedia's sister projects. This template links an article to a page on Wikimedia Commons. Without any arguments, the template uses Wikidata to automatically link to an available gallery or category (if gallery is not available). With an argument, the template links to the named gallery.

Usage

{{Commons}}	—puts link-box with current page's name.
{{Commons|pagename}}	—puts link-box connecting title pagename.
{{Commons|pagename|showname}}	—puts link-box showing the title showname.
{{Commons|pagename|position=left}}	—floats link-box to the left side.

To place this template on the page, type {{Commons|pagename}}, where pagename is the name of a page on Wikimedia Commons (defaults to "{{PAGENAME}}", the end-name of a page where used).

• The optional 2nd parameter gives the displayed link text.
• The |position= parameter accepts one keyword, left, to float the box to the left instead of to the right.
• To link to a Category, use the related template {{Commons category|catname}}, where catname is the name of the category.

Location

If using a large, graphical template produces odd layout problems, like the excessive white space shown on the right of this screenshot, then switch to a different sister template.

Generally:

N Do not place this template or any box-type template in a section all by itself.

N Do not place this template in a section containing columns without floating left.

N Do not indent this template with colon (:) or a bullet (*) markup.

Specifically:

• In articles, this template should be placed at the top of the last section on the page so that it floats to the right of that section.
  • See Wikipedia:Wikimedia sister projects#Where to place links for more information and alternatives.
• In disambiguation pages, this template is usually placed at the top of the page.
• In categories, this template should be grouped with other templates at the beginning of the category introduction. This avoids unnecessary white space as any text is floated around the template boxes.

Defaults

The pagename defaults to wiki-variable "{{PAGENAME}}", which is the end-name of the page where used. For a Template:Txxx, the {{PAGENAME}} would be the end-name "Txxx". For a Category:Catxxx, that page would have {{PAGENAME}} as the end-name "Catxxx".

The default positioning of the link-box is to the right-side.

Examples

{{Commons}}

produces

{{Commons|Reconquista}}

produces

{{Commons|Category:Reconquista}}

produces

{{Commons|Reconquista|retaking of the Iberian Peninsula}}

produces

{{Commons|Reconquista|position=left}}

produces

Template data

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Commons in articles based on its TemplateData.

TemplateData for Commons

Creates a small box with a link to a related page on Wikimedia Commons.

Template parameters

Parameter		Description	Type	Status
Pagename	1	The page name on Commons. The article's page name is used as a default.	String	optional
Showname	2	Optional displayed link text.	String	optional
Position	position	Position to display the box: 'left' floats the box to the left rather than the default which is on the right.	String	optional

Tracking categories

Normal categories

• Category:Commons link from Wikidata (15,362)
• Category:Commons link is on Wikidata (2,360)

Maintenance categories

• Category:Commons link is defined as the pagename (12)
• Category:Commons link is locally defined (7,443)
• Category:Commons link is the pagename (16,563)
• Category:Inconsistent wikidata for Commons gallery (27)

See also

• Wikipedia:Manual of Style/Layout § External links
• {{Commons}}—shows Commons box
• {{Commons-inline}}—shows Commons gallery inline
• {{Commons category}}—shows Commons category box
• {{Commons category-inline}}—shows Commons category inline
• {{Commons category multi}}—to list up to twelve categories
• {{Commons and category}}—shows Commons box with both gallery and category
• {{Commons and category inline}}—shows Commons gallery and category inline
• {{Copy to Wikimedia Commons}}
• {{Wikimedia Commons redirect}}—specialized soft redirect template for Commons
• {{Wiki category}}—to link to a gallery hosted on Wikipedia
• mw:Manual:Pywikibot/commonscat.py

• {{Sister project links}}—to link all Wikinews, Wikisource, etc.
• {{Wikibooks}} / {{Wikibooks inline}}
• {{Wikidata property}}
• {{Wikinews}} / {{Wikinews inline}}
• {{Wikiquote}} / {{Wikiquote inline}}
• {{Wikisource}} / {{Wikisource inline}}
• {{Wikispecies}} / {{Wikispecies inline}}
• {{Wikiversity}} / {{Wikiversity inline}}
• {{Wikivoyage}} / {{Wikivoyage inline}}
• {{Wiktionary}} / {{Wiktionary inline}}