Template:Television episode ratings/doc

Usage

The purpose of the {{Television episode ratings}} template is to add a formatted ratings table to pages for television series, specifically either the main article, list of episodes article, or individual season articles, displaying the ratings for each episode of a season, for up to 50 episodes. The template can start from the 0th episode, in the case of a special episode preceding the first episode.

Syntax

<syntaxhighlight lang="wikitext">

Viewership and ratings per episode of TEXT

No.	Series	Air date	Timeslot (ET)	Template:Ref heading

</syntaxhighlight>

Examples

Basic example

Template:Collapse top <syntaxhighlight lang="wikitext">

Viewership and ratings per episode of Television episode ratings/doc

No.	Title	Air date	Rating/share (18–49)	Viewers (millions)	DVR (18–49)	DVR viewers (millions)	Total (18–49)	Total viewers (millions)
1	"Pilot"	September 22, 2014	3.2/9	13.83	1.8	5.32	5.0	19.22
2	"Single Point of Failure"	September 29, 2014	3.1/8	13.36	1.5	4.56	4.6	17.94
3	"A Cyclone"	October 6, 2014	2.6/7	12.05	1.3	4.49	3.9	16.54
4	"Shorthanded"	October 13, 2014	2.4/6	11.51	1.2	4.18	3.6	15.69

</syntaxhighlight>

Viewership and ratings per episode of Television episode ratings/doc

No.	Title	Air date	Rating/share (18–49)	Viewers (millions)	DVR (18–49)	DVR viewers (millions)	Total (18–49)	Total viewers (millions)
1	"Pilot"	September 22, 2014	3.2/9	13.83	1.8	5.32	5.0	19.22
2	"Single Point of Failure"	September 29, 2014	3.1/8	13.36	1.5	4.56	4.6	17.94
3	"A Cyclone"	October 6, 2014	2.6/7	12.05	1.3	4.49	3.9	16.54
4	"Shorthanded"	October 13, 2014	2.4/6	11.51	1.2	4.18	3.6	15.69

Extra options

Hiding columns, Width, Font size, Timeslot, TBD & N/A cells, References, Multiple episodes Template:Collapse top <syntaxhighlight lang="wikitext">

Viewership and ratings per episode of Television episode ratings/doc

No.	Title	Air date	Timeslot (ET)	Viewers (millions)	DVR viewers (millions)	Total viewers (millions)	Template:Ref heading
1	"Pilot"	September 22, 2014	Monday 8:00 p.m.	13.83	5.32	19.22	Template:Dummyref
2	"Single Point of Failure"	September 23, 2014	Tuesday 8:00 p.m.	13.36	4.56	17.94	Template:Dummyref
3	"A Cyclone"	September 30, 2014		12.05	4.49	16.54	Template:Dummyref
4–5	"Shorthanded"	October 6, 2014	Monday 8:00 p.m.	TBD	—	—

</syntaxhighlight>

Viewership and ratings per episode of Television episode ratings/doc

No.	Title	Air date	Timeslot (ET)	Viewers (millions)	DVR viewers (millions)	Total viewers (millions)	Template:Ref heading
1	"Pilot"	September 22, 2014	Monday 8:00 p.m.	13.83	5.32	19.22	Template:Dummyref
2	"Single Point of Failure"	September 23, 2014	Tuesday 8:00 p.m.	13.36	4.56	17.94	Template:Dummyref
3	"A Cyclone"	September 30, 2014		12.05	4.49	16.54	Template:Dummyref
4–5	"Shorthanded"	October 6, 2014	Monday 8:00 p.m.	TBD	—	—

Parameters

Template parameters

Type	Parameter		Description	Type	Status
Title	Title	title	The title of the series in the table's caption, which uses {{Screen reader-only}} to not be displayed in a browser but be voiced by a screen reader, defaults to the page name. Set this parameter (in plain text) to change the series' title if it should not be the page name. Format: Text	Text	Optional
Show caption	Show caption	show_caption	To override {{Screen reader-only}} and display the caption in a browser, especially when the table is not directly below a heading. Format: y	Text	Optional
Width	Width	width	Width of the ratings table, as a percentage without the % sign, if it is required to be something other than the automatic width. Format: 100	Number	Optional
Font size	Font size	fontsize	Font size of the ratings table, as a percentage without the % sign, if it is required to be something other than the automatic size. Format: 100	Number	Optional
Toggle Columns	Series	show_series	Whether or not to show the "Series" column instead of the "title" column. Format: y	Text	Optional
	Timeslot	show_timeslot	Whether or not to show the Timeslot column, if it is required. This field should only be used for shows that frequently change timeslots, such as reality shows; do not use for one-offs, such as special timeslot premieres, finales, or crossover episodes. Format: y	Text	Optional
	Rating/share	hide_rs	Whether or not to hide the Rating/share column, if it is not required. Format: y	Text	Optional
	Viewers	hide_viewers	Whether or not to hide the Viewers column, if it is not required. Format: y	Text	Optional
	DVR	hide_dvr	Whether or not to hide the DVR column, if it is not required. Format: y	Text	Optional
	DVR viewers	hide_dvrv	Whether or not to hide the DVR viewers column, if it is not required. Format: y	Text	Optional
	Total	hide_total	Whether or not to hide the Total column, if it is not required. Format: y	Text	Optional
	Total viewers	hide_totalv	Whether or not to hide the Total viewers column, if it is not required. Format: y	Text	Optional
	References	refs_col	Whether or not to show the unsortable ending References column, if it is required. Format: y	Text	Optional
	No Share	noshare	Inclusion removes "/share" from the Rating/share column header, changing it to Rating, especially for use with cable series. Format: y	Text	Optional
Values	Number	n{0-5}	Allow for modification of the number entry, in the case of a special or different numbering scheme.	Text	Optional
	TV series name	series{0-5}	The name of the TV series. Used in articles like "Elseworlds"	Text	Required
	Title	title{0-50}	The title of the episode, linked to the ratings part of the episode article if exists. Format: [[Pilot#ep1|Pilot]]	Link	Required
	Date	date{0-50}	The date that the episode originally aired, matching the date in the episode table. Format: September 22, 2014 Note: Using {{Start date}} does not allow for correct sorting of dates.	Date	Required
	Timeslot	timeslot{0-50}	The timeslot for the episode, including the day of the week and hour. Format: Wednesday 9:00 pm	Text	Optional
	Timeslot length	timeslot_length{0-50}	How many consecutive episodes that the series has stayed in the same timeslot for. Format: 2 Exclusion: 1	Number	Optional
	Rating/share	rs{0-50}	The rating/share for the episode, sourced accordingly. Format: 3.2/9 Exclusion: {{N/A|TBD}} or {{N/A}} when set to n/a	Number	Optional
	Rating/share data sort	rsds{0-50}	Manually set the datasort value for rating/share data. Format: 123	Number	Optional
	Viewers	viewers{0-50}	The viewers (in millions) for the episode, sourced accordingly. Format: 13.83 Exclusion: {{N/A|TBD}} or {{N/A}} when set to n/a	Number	Optional
	DVR	dvr{0-50}	The DVR rating for the episode, sourced accordingly. Format: 1.8 Exclusion: {{N/A|TBD}} or {{N/A}} when set to n/a	Number	Optional
	DVR viewers	dvrv{0-50}	The DVR viewers for the episode, sourced accordingly. Format: 5.32 Exclusion: {{N/A|TBD}} or {{N/A}} when set to n/a	Number	Optional
	Total	total{0-50}	The total rating for the episode, sourced accordingly. Format: 5.0 Exclusion: {{N/A|TBD}} or {{N/A}} when set to n/a	Number	Optional
	Total viewers	totalv{0-50}	The total viewers for the episode, sourced accordingly. Format: 19.22 Exclusion: {{N/A|TBD}} or {{N/A}} when set to n/a	Number	Optional
	References	ref{0-50}	The reference for viewer values for the episode; they will only if the References column is included. Format: Typical reference	Reference	Optional
	Next episode	next{0-50}	Determine whether the ratings apply for two episodes under the same name, and if so, list the episode number as "x/x+1". Format: y Example: |next4=y will display the fourth episode's number as "4/5".	Text	Optional

Related templates

• {{Australian television episode ratings}}