Template:Television season ratings

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

Usage

The purpose of the {{Television season ratings}} template is to add a formatted ratings table to pages for television series, specifically the main article, displaying the timeslots, ratings and similar information for each season, for up to 50 seasons.

Syntax

{{Television season ratings
| title                     = TEXT
| multiseries               = TEXT
| width                     = NUMBER

| series{1-50}              = TEXT
| series_length{1-50}       = TEXT
| n{1-50}                   = TEXT
| link{1-50}                = TEXT
| timeslot{1-50}            = TEXT
| timeslot_length{1-50}     = TEXT
| network{1-50}             = TEXT
| network_length{1-50}      = TEXT
| episodes{1-50}            = NUMBER
| start{1-50}               = DATE
| startrating{1-50}         = NUMBER
| end{1-50}                 = DATE
| endrating{1-50}           = NUMBER
| season{1-50}              = NUMBER
| rank{1-50}                = NUMBER
| viewers{1-50}             = NUMBER
| 18_49_rank{1-50}          = NUMBER
| 18_49_rating{1-50}        = NUMBER
| references{1-50}          = REFERENCE(S)

| season_length{1-50}       = TEXT
| rank_length{1-50}         = TEXT
| viewers_length{1-50}      = TEXT
| 18_49_rank_length{1-50}   = TEXT
| 18_49_rating_length{1-50} = TEXT
| references_length{1-50}   = TEXT

| hide_timeslot             = TEXT
| hide_tv_season            = TEXT
| hide_viewers              = TEXT
| hide_rank                 = TEXT
| hide_18_49_rank           = TEXT
| hide_18_49_rating         = TEXT
| hide_FLratings            = TEXT
| show_caption              = TEXT
| show_network              = TEXT
| show_references           = TEXT
| timezone                  = TEXT
| unit                      = TEXT
| nolink                    = TEXT
}}

Example

Code

{{Television season ratings
| title            = Show

| link1            = Main Page
| timeslot1        = Monday 10 p.m.
| timeslot_length1 = 2
| episodes1        = 13
| start1           = {{Start date|2013|6|24}}
| startrating1     = 13.53
| end1             = {{End date|2013|9|16}}
| endrating1       = 12.10
| season1          = 2012–13
| rank1            = 50
| viewers1         = 11.19
| 18_49_rank1      = 4
| 18_49_rating1    = 2.7/8

| link2            = Main Page
| episodes2        = 13
| start2           = {{Start date|2014|6|30}}
| startrating2     = 9.41
| end2             = {{End date|2014|9|22}}
| endrating2       = 7.52
| season2          = 2013–14
| rank2            = 76
| viewers2         = 7.17
| 18_49_rank2      = 9
| 18_49_rating2    = 1.6/5

| link3            = Main Page
| timeslot3        = Thursday 9 p.m.
| episodes3        = 13
| start3           = {{Start date|2015|6|25}}
| startrating3     = 6.25
| end3             = {{End date|2015|9|10}}
| endrating3       = 4.23
| season3          = 2014–15
| rank3            = 43
| viewers3         = 4.70
| 18_49_rank3      = 10
| 18_49_rating3    = 1.0/4
}}

Viewership and ratings per season of *Show*
Season	Timeslot (ET)	Episodes	First aired		Last aired		TV season	Viewership rank	Avg. viewers (millions)	18–49 rank	Avg. 18–49 rating
Season	Timeslot (ET)	Episodes	Date	Viewers (millions)	Date	Viewers (millions)	TV season	Viewership rank	Avg. viewers (millions)	18–49 rank	Avg. 18–49 rating
1	Monday 10 p.m.	13	June 24, 2013 (2013-06-24)	13.53	September 16, 2013 (2013-09-16)	12.10	2012–13	50	11.19	4	2.7/8
2	Monday 10 p.m.	13	June 30, 2014 (2014-06-30)	9.41	September 22, 2014 (2014-09-22)	7.52	2013–14	76	7.17	9	1.6/5
3	Thursday 9 p.m.	13	June 25, 2015 (2015-06-25)	6.25	September 10, 2015 (2015-09-10)	4.23	2014–15	43	4.70	10	1.0/4

Parameters

Parameter			Description	Type	Status
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
Multi-Series		multiseries	Set to include the "Series" column, for producting a table with multiple series. Format: y	Text	Optional
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
Values	Series	series{1-50}	Use it `\|multiseries=` is set, to include the linked series title. Format: Arrow	Text/Link	Optional
	Series Length	series_length{1-50}	Use if `\|multiseries=` and `\|series=` are set, to determine the rowspan of the linked series title. Include even if it is set to 1. Format: 8	Number	Optional
	Number	n{1-50}	Customizable season number to change from the default automatically incrementing number, useful for multiple series where the season number is not the same as the parameter number. Format: 8	Number	Optional
	Link	link{1-50}	The link to the season's ratings table on the episodes page if available, without square brackets, where more detailed information is available. Format: List of The 100 episodes#Season 1	Text	Optional
	Timeslot	timeslot{1-50}	The timeslot for the season in question, including the day of the week and hour. Format: Wednesday 9:00 pm	Text	Optional
	Timeslot Length	timeslot_length{1-50}	How many consecutive seasons that the series has stayed in the same timeslot for. Format: 2 Exclusion: 1	Number	Optional
	Network	network{1-50}	The Network for the season in question. Format: CBS	Text	Optional
	Network Length	network_length{1-50}	How many consecutive seasons that the series has stayed on the same Network. Format: 2 Exclusion: 1	Number	Optional
	Episodes	episodes{1-50}	The number of episodes included in the season in question. The count is for the total episodes, rather than how many have aired. Format: 16 Exclusion: TBA	Number	Optional
	Start date	start{1-50}	The start date for the entire season in question; this is, the air date of the premiere episode. A start date is required for the row to display. Format: `{{Start date\|2014\|03\|19}}` Exclusion: TBA	Date	Required
	Premiere viewers	startrating{1-50}	The viewers for the premiere of the season in millions, sourced accordingly; this should be the same value that is displayed in the season's episode table for the episode. Format: 2.73 Exclusion: TBD	Number	Optional
	End date	end{1-50}	The end date for the entire season in question; this is, the air date of the finale episode. Format: `{{End date\|2014\|06\|11}}` Exclusion: TBA	Date	Optional
	Finale viewers	endrating{1-50}	The viewers for the finale of the season in millions, sourced accordingly; this should be the same value that is displayed in the season's episode table for the episode. Format: 2.73 Exclusion: TBD	Number	Optional
	TV season	season{1-50}	The television season of the season in question. This should only be in the format "2015–16", so that it directly links to 2015–16 United States network television schedule, for example. It will not automatically link if `\|nolink=` is set. Format: 2015–16	Numbers	Required
	Rank	rank{1-50}	The official rank released by the network for the entire season compared to other series, sourced accordingly. Format: 150 Exclusion: TBD	Number	Optional
	Viewers	viewers{1-50}	The official average viewers released by the network for the entire season, sourced accordingly. Format: 2.59 Exclusion: TBD	Number	Optional
	18–49 rank	18_49_rank{1-50}	The official 18–49 rank released by the network for the entire season, sourced accordingly. Format: 2.59 Exclusion: TBD	Number	Optional
	18–49 rating	18_49_rating{1-50}	The official 18–49 rating released by the network for the entire season, sourced accordingly. Format: 2.59 Exclusion: TBD	Number	Optional
	References	references{1-50}	A column dedicated to listing references. Format: {{cite web}} Exclusion: N/A	Reference	Optional
Span Columns	Season	season_length{1-50}	The rowspan of the season_length column. Set to a number for the first season, and set corresponding seasons to hide. Example format: 3 for Season 1, hide for Season 2 and Season 3.	Number/Text	Optional
	Rank	rank_length{1-50}	The rowspan of the rank_length column. Set to a number for the first season, and set corresponding seasons to hide. Example format: 3 for Season 1, hide for Season 2 and Season 3.	Number/Text	Optional
	Viewers	viewers_length{1-50}	The rowspan of the viewers_length column. Set to a number for the first season, and set corresponding seasons to hide. Example format: 3 for Season 1, hide for Season 2 and Season 3.	Number/Text	Optional
	18–49 rank	18_49_rank_length{1-50}	The rowspan of the 18_49_rank_length column. Set to a number for the first season, and set corresponding seasons to hide. Example format: 3 for Season 1, hide for Season 2 and Season 3.	Number/Text	Optional
	18–49 rating	18_49_rating_length{1-50}	The rowspan of the 18_49_rating_length column. Set to a number for the first season, and set corresponding seasons to hide. Example format: 3 for Season 1, hide for Season 2 and Season 3.	Number/Text	Optional
	References	references_length{1-50}	The rowspan of the references column. Set to a number for the first season, and set corresponding seasons to hide. Example format: 3 for Season 1, hide for Season 2 and Season 3.	Number/Text	Optional
Toggle Columns	Timeslot	hide_timeslot	Whether or not to hide the Timeslot column, if it is not required (e.g. for shows that frequently change timeslots). Format: y	Text	Optional
	TV season	hide_tv_season	Whether or not to hide the TV season column, if it is not required (e.g. for shows on kids' channels such as Disney/Nickelodeon). Format: y	Text	Optional
	Viewers	hide_viewers	Whether or not to hide the Viewership column, if it is not required (e.g. for shows on kids' channels such as Disney/Nickelodeon). Format: y	Text	Optional
	Viewership rank	hide_rank	Whether or not to hide the Viewership rank column, if it is not required (e.g. for shows on kids' channels such as Disney/Nickelodeon). Format: y	Text	Optional
	18–49 rank	hide_18_49_rank	Whether or not to hide the 18–49 rank column, if it is not required. Format: y	Text	Optional
	Avg. 18–49 rating	hide_18_49_rating	Whether or not to hide the Avg. 18–49 rating column, if it is not required. Format: y	Text	Optional
	Avg. First/last aired ratings	hide_FLratings	Whether or not to hide the ratings for the first/last aired columns, if it is not required. Setting this will condense the header row further when it hide the relevant cells. Format: y	Text	Optional
	Show Caption	show_caption	Whether or not to show the table's caption, if it is not placed immediately below a heading, where the heading is effectively identical to the table's caption. Format: y	Text	Optional
	Show Network	show_network	Whether or not to show the Network column, if it is required. Format: y	Text	Optional
	Show References	show_references	Whether or not to show the References column, if it is required. Format: y	Text	Optional
Timezone		timezone	The timezone of all of the timeslots for the series. Format: [[Eastern Time Zone\|ET]] Exclusion: ET	Text/Link	Optional
Unit		unit	The unit override for the Viewers column header. Format: (thousands) Exclusion: (millions) Hide:	Text	Optional
No link		nolink	If set, it will allow the season column to be linked manually, or simply plain text. Format: y	Text	Optional

The above documentation is transcluded from Template:Television season ratings/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.