Template:Category link/doc

This is a documentation subpage for Template:Category link.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 571,000 pages, or roughly 1% of all pages.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

Shortcuts

{{cl}}
{{CL}}
{{categ}}
{{category}}
{{Cat}}

{{Cl|category name}}

{{Cl|Category:category name}}

{{Cl|category name|link text}}

{{Cl|category name|link text|count=yes}}

{{Cl|category name|link text|count=yes|count_type=type}}

{{Cl|category name|link text|count=yes|count_type=type|backlog=backlog threshold}}

{{category link}} or its alias {{cl}} produces a link to a category in a similar fashion to {{Tl}} for a template. For example:

{{Cl|Africa}} produces: Category:Africa

To specify the text used for the link, add it as a second parameter:

{{Cl|Africa|this category}} produces: this category

To add a count of everything in the category, add the |count=yes parameter:

{{Cl|Africa|count=yes}} produces: Category:Africa ( 34 )

If you just want to get a count of pages, files, or subcats, use the |count_type= parameter:

{{Cl|Africa|count=yes|count_type=all}} produces: Category:Africa ( 34 ) (default)

{{Cl|Africa|count=yes|count_type=pages}} produces: Category:Africa ( 6 )

{{Cl|Africa|count=yes|count_type=subcats}} produces: Category:Africa ( 28 )

{{Cl|Africa|count=yes|count_type=files}} produces: Category:Africa ( 0 )

If you want to make counts standout for categories that have a backlog, use |backlog=:

{{Cl|Africa|count=yes|backlog=20}} produces: Category:Africa ( 34 )

{{C}}, which produces output such as: Africa and Afrika
{{Cls}}, which produces output such as: Cat:Africa
{{Clc}}, which produces output such as: Category:Africa (34) and Category:Africa (6)
{{lc}}, which produces output such as: Category:Africa (edit | talk | history | links | watch | logs)
{{lcs}}, which produces output such as Category:Africa(edit talk links history)
{{tl}}, which links produces a link to a template surrounded by template-style double-braces (e.g. {{Africa}}).
Category:Internal category-link templates
Category:Internal link templates
{{Category see also}}

Template	Example output
{{c}}	Example
{{cl}}	Category:Example
{{cls}}	Cat:Example

Template	Example output
{{cconly}}	7
{{clc}}	Category:Example (7)
{{lc}}	Category:Example (edit \| talk \| history \| links \| watch \| logs)
{{lcs}}	Category:Example(edit talk links history)

This template creates a link to a category and optionally displays the page count. If the page count exceeds a backlog threshold, it will be highlighted.

Template parameters
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Category name	`1`	The name of the category to link to. Example ExampleCategory	String	required
Display text	`2`	The text to display for the link. If not provided, the category name is used. Example Custom Display Text	String	optional
Show count	`count`	Specifies whether to display the number of pages in the category. Default false Example true	Boolean	optional
Backlog threshold	`backlog`	The threshold for the page count. If the count exceeds this value, it will be highlighted. Example 10	Number	optional
Count type	`count_type`	Specifies the type of count to display (e.g., pages, files, or subcategories). Suggested values `all` `pages` `subcats` `files` Default all Example pages	String	optional

See also