Template:Commons/doc

This is a documentation subpage for Template:Commons (see that page for the template itself).
It contains usage information, categories and other content that is not part of the original template page.

This template is part of Wikipedia's sister projects. This template links an article to a page on Wikimedia Commons, containing a gallery of related images.

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 {{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.

Template:Cross Do not place this template in a section all by itself.

Template:Cross Do not place this template in a section containing columns.

This template should normally be placed at the top of the last section in the article, or consider using {{Commons-inline}} instead. See Wikipedia:Wikimedia sister projects for further recommendations about the best choice of template for various situations.

On disambiguation pages, this template should be listed above other text, but below any cleanup templates, images, infoboxes or navboxes.

Defaults

The pagenam 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 documentation for this template used by VisualEditor and other tools.

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

See also

• Template:Commons-inline—shows Commons gallery inline
• Template:Commons category
• Template:Commons category-inline—shows Commons category inline
• Template:Commons category multi—to list up to six categories
• Template:Commons and category—shows Commons box with both gallery and category
• Template:Commons and category-inline—shows Commons gallery and category inline
• Template:Sister project links—to link all Wikinews, Wikisource, etc.
• {{Wikilivres}}