View source for Template:Commons/doc

{{documentation subpage}}
{{high-risk| 170,000+ }}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

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

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

To place this template on the page, type '''<nowiki>{{</nowiki>Commons|''pagename''}}''', where ''pagename'' is the name of a page on Wikimedia Commons (defaults to <small><nowiki>"{{PAGENAME}}"</nowiki></small>, the end-name of a page where used).
* The optional 2nd parameter gives the displayed link text.
* The {{para|position}} parameter accepts one keyword, <code>left</code>, to float the box to the left instead of to the right.
* To link to a ''Category,'' use {{tlx|Commons category|''catname''}}, where ''catname'' is the name of the category.

===Location===
[[File:Sister link template columns problem.jpg|thumb|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.]]

{{cross}} '''Do not place this template in a section all by itself.'''

{{cross}} '''Do not place this template in a section containing columns.'''

This template should normally be placed at the top of the ''External links'' section at the end of an article, if the article has a section for [[WP:EL|external links]].  If no such section exists, then please place it at the top of the last section in the article, or consider using {{tlx|Commons-inline}} instead.  See [[Wikipedia:Wikimedia sister projects]] for further recommendations about the best choice of template for various situations.

On [[WP:DAB|disambiguation pages]], this template should be listed above other text, but below any cleanup templates, images, infoboxes or navboxes.<!-- Per WP:ACCESS, cleanup templates, images, infoboxes, and navboxes are always first. -->

===Defaults===
The ''pagenam'' defaults to wiki-variable <small><nowiki>"{{PAGENAME}}"</nowiki></small>, which is the end-name of the page where used. For a Template:Txxx, the <small><nowiki>{{PAGENAME}}</nowiki></small> would be the end-name "Txxx". For a Category:Catxxx, that page would have <small><nowiki>{{PAGENAME}}</nowiki></small> as the end-name "Catxxx".

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

===Examples===
{| style="border:1px solid #808080; padding:1px;"
|{{tl2|Commons}}
|}
produces
{{Commons}}
{{-}}

{| style="border:1px solid #808080; padding:1px;"
|{{tl2|Commons|Reconquista}}
|}
produces
{{Commons|Reconquista}}
{{-}}

{| style="border:1px solid #808080; padding:1px;"
|{{tl2|Commons|Category:Reconquista}}
|}
produces
{{Commons|Category:Reconquista}}
{{-}}

{| style="border:1px solid #808080; padding:1px;"
|{{tl2|Commons|Reconquista|retaking of the Iberian Peninsula}}
|}
produces
{{Commons|Reconquista|retaking of the Iberian Peninsula}}
{{-}}

{| style="border:1px solid #808080; padding:1px;"
|{{tlx|Commons|Reconquista|position{{=}}left}}
|}
produces
{{Commons|Reconquista|position=left}}
{{-}}

=== See also ===
* [[Template:Commons category]] - Commons box with category
* [[Template:Commons and category]] – shows Commons box with both gallery and category
* [[Template:Commons-inline]] – inline link to Commons in list format, not a box

<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Exclude in print]]
[[Category:Interwiki link templates|Commons]]
[[Category:Wikimedia Commons templates|{{PAGENAME}}]]

[[af:Sjabloon:Commons]]
[[as:Template:Commons]]
[[als:Vorlage:Commons]]
[[ar:قالب:كومنز]]
[[ast:Plantilla:Commons]]
[[az:Şablon:Commons]]
[[zh-min-nan:Template:Commons]]
[[be:Шаблон:Commons]]
[[be-x-old:Шаблён:Commons]]
[[bar:Vorlage:Commons]]
[[bs:Šablon:Commons]]
[[bg:Шаблон:Общомедия]]
[[ca:Template:Commons]]
[[cs:Šablona:Commons]]
[[cy:Nodyn:Comin]]
[[da:Skabelon:Commons]]
[[de:Vorlage:Commons]]
[[el:Πρότυπο:Commons]]
[[es:Plantilla:Commons]]
[[eo:Ŝablono:Commons]]
[[et:Mall:Commons]]
[[eu:Txantiloi:Commons]]
[[fa:الگو:ویکی‌انبار]]
[[fr:Modèle:Commons]]
[[fy:Berjocht:Commons]]
[[ga:Teimpléad:Cómhaoin]]
[[gl:Template:Commons]]
[[ko:틀:Commons]]
[[hy:Կաղապար:Վիքիպահեստ]]
[[hsb:Předłoha:Commons]]
[[hr:Predložak:Commons]]
[[io:Template:Commons]]
[[ilo:Template:Commons]]
[[id:Templat:Commons]]
[[ia:Patrono:Commons]]
[[iu:Template:Commons]]
[[ik:Template:Commons]]
[[is:Snið:Commons]]
[[it:Template:Commons]]
[[he:תבנית:Commons]]
[[kn:ಟೆಂಪ್ಲೇಟು:Commons]]
[[ku:Şablon:Commons]]
[[la:Formula:Communia2]]
[[lv:Veidne:Commons]]
[[lb:Template:Commons]]
[[lt:Šablonas:Commons]]
[[li:Sjabloon:Commons]]
[[hu:Sablon:Commons]]
[[mk:Шаблон:Commons]]
[[ms:Templat:Commons]]
[[nl:Sjabloon:Commons]]
[[ja:Template:Commons]]
[[ka:თარგი:Commons]]
[[ml:ഫലകം:Commons]]
[[mr:साचा:कॉमन्स]]
[[no:Mal:Commons]]
[[nn:Mal:Commons]]
[[oc:Modèl:Commons]]
[[nds:Vörlaag:Commons]]
[[pa:ਨਮੂਨਾ:ਕਾਮਨਜ਼]]
[[pl:Szablon:Commons]]
[[pt:Predefinição:Commons]]
[[ro:Format:Commons]]
[[ru:Шаблон:Commons]]
[[sq:Stampa:Commons]]
[[scn:Template:Commons]]
[[simple:Template:Commons]]
[[sk:Šablóna:Commons]]
[[sl:Predloga:Zbirka]]
[[sr:Шаблон:Commons]]
[[sh:Template:Commons]]
[[fi:Malline:Commons]]
[[su:Citakan:Commons]]
[[sv:Mall:Commons]]
[[tl:Template:Commons]]
[[tt:Ürnäk:Commons]]
[[vi:Tiêu bản:Commons]]
[[th:แม่แบบ:คอมมอนส์]]
[[tr:Şablon:Commons]]
[[wa:Modele:Commons]]
[[uk:Шаблон:Commons]]
[[ur:سانچہ:Commons]]
[[zh-yue:Template:同享]]
[[zh:Template:Commons]]
</includeonly>