Template:Annual readership/sandbox

Please click here for an interactive graph showing page views for Template:Annual readership/sandbox, extending from one year ago through yesterday. Once you get there, you will be able to change to line graph or other formats, display page views logarithmically if desired, change the date range on the x-axis to shorter or longer periods, add the names of other Wikipedia pages to compare to, and many other options. You can find complete documentation for the Pageviews graph tool here.

This is the template sandbox page for Template:Annual readership (diff).
See also the companion subpage for test cases.

Template documentation[view] [edit] [history] [purge]

Redirects

Per Wikipedia:Templates for discussion/Log/2024 August 25#Template:Annual readership, this template is hidden from view until built-in graphs are enabled again.
See pageviews.wmcloud.org for pageview graphs in the meantime. The data for each page can be made easily accessible via Pageviews.js, which adds it to the Tools menu, or via the XTools gadget, which inserts the view count below the article title.

This template is used on approximately 53,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Preview message: Transclusion count updated automatically (see documentation).

This template reports the daily page views for an article over a period of time (default: the last year), placing them in a suitable frame with a heading. It is typically placed on an article's talk page below other talk page banners.

Usage

Basic syntax (annual data):

{{Annual readership}}

Template syntax with optional parameters:

{{Annual readership|expanded=|days=|target=|title=|color=|scale=|width=|height=}}

Optional parameters

|expanded= can be used to override the default auto-collapsing of the message box. To prevent the graph from being collapsed on page load, use |expanded=true.
|days= (default: 365) can be used to change the number of pageview days depicted in the graph.
|target= (default: {{SUBJECTPAGENAME}}) can be used to simultaneously specify the page in the graph title (if |title= is not specified) and the page for which page traffic is displayed.
|title= (default: see notes) can be used to specify the page in the graph title.
|color= (default: #00f) can be used to change the graph color; accepted inputs include HTML color names (e.g., red) and hex codes.
|scale= (default: linear) can be used to change the scale of the y axis; accepted inputs: linear, log, pow, sqrt, quantile, quantize, and threshold.
|width= (default: 570) may be used to change the width in pixels of the image.
Note: Default of 570px is used to match standard Talk page boxed items; values outside the range of 400–980 may be problematic.
|height= (default: 200) may be used to change the height.

Notes about the graph title

If both |title= and |target= are not specified, the graph title varies depending on the namespace of the page where this template is used.

Title if placed on an article talk page:
Daily pageviews of this article
Title if placed on a page in any other talk namespace (e.g., "User talk:", "Template talk:", "Wikipedia talk:", etc.):
Daily pageviews of {{SUBJECTPAGENAME}}
Title if placed on any subject page (i.e., pages in namespaces like "User:", "Template:", "Wikipedia:", etc.):
Daily pageviews of this page

If |title= is not specified, but |target= is specified, the graph title is set as "Daily pageviews of target page", with the target page linked.

For example, inputting |target=XYZ would set the graph title as:
Daily pageviews of XYZ

If |title= is specified, regardless of the specification of |target=, the graph title is set as "Daily pageviews of text", with the text unlinked.

For example, inputting |title=XYZ would set the graph title as:
Daily pageviews of XYZ
For example, inputting |title=[[XYZ]] would set the graph title as:
Daily pageviews of XYZ

Examples

Defaults (collapsed)

{{Annual readership}}

Defaults (uncollapsed)

{{Annual readership|expanded=true}}

Specified target page, logarithmic scale, and green coloring (collapsed)

{{Annual readership|days=150|target=Pancake|scale=log|color=green}}

Same except linear scale:

{{Annual readership|days=150|target=Pancake|scale=linear|color=green}}

Specified target page, linear scale, and red coloring (uncollapsed)

{{Annual readership|days=30|expanded=true|target=Rubber duck|scale=linear|color=red}}

TemplateData

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

TemplateData for Annual readership

No description.

Template parameters[Edit template data]
Parameter		Description	Type	Status
expanded	`expanded`	Disables auto-collapsing of the graph message box on page load Suggested values `true`	String	optional
days	`days` `1`	Number of pageview days depicted Default 365	Number	optional
target	`target` `2`	Page for which traffic is displayed Default {{SUBJECTPAGENAME}}	Page name	optional
title	`title`	Page in the graph title. See "Notes about the graph title" for the default	Content	optional
Graph color	`color`	no description Suggested values `red` Default #00f	String	optional
Y-axis scale	`scale`	no description Suggested values `linear` `log` `pow` `sqrt` `quantile` `quantize` `threshold` Default linear	String	optional
Image width pixels	`width`	Default matches standard Talk page boxed items; values outside 400–980 may be problematic Default 570	Number	optional
height	`height`	no description Default 200	Number	optional