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
{{Television episode ratings
| title = TEXT
| width = NUMBER
| fontsize = NUMBER
| show_series = TEXT
| show_timeslot = TEXT
| noshare = TEXT
| hide_rs = TEXT
| hide_viewers = TEXT
| hide_dvr = TEXT
| hide_dvrv = TEXT
| hide_total = TEXT
| hide_totalv = TEXT
| refs_col = TEXT
| n{0-50} = TEXT
| series{0-5} = TEXT
| title{0-50} = TEXT
| date{0-50} = DATE
| timeslot{0-50} = TEXT
| timeslot_length{0-50} = NUMBER
| rs{0-50} = NUMBER
| rsds{0-50} = NUMBER
| viewers{0-50} = NUMBER
| dvr{0-50} = NUMBER
| dvrv{0-50} = NUMBER
| total{0-50} = NUMBER
| totalv{0-50} = NUMBER
| ref{0-50} = REFERENCE
| next{0-50} = TEXT
}}
Examples
Basic example
Code
|
|---|
{{Television episode ratings
| title1 = [[#ep1|Pilot]]
| date1 = September 22, 2014
| rs1 = 3.2/9
| viewers1 = 13.83
| dvr1 = 1.8
| dvrv1 = 5.32
| total1 = 5.0
| totalv1 = 19.22
| title2 = [[#ep2|Single Point of Failure]]
| date2 = September 29, 2014
| rs2 = 3.1/8
| viewers2 = 13.36
| dvr2 = 1.5
| dvrv2 = 4.56
| total2 = 4.6
| totalv2 = 17.94
| title3 = [[#ep3|A Cyclone]]
| date3 = October 6, 2014
| rs3 = 2.6/7
| viewers3 = 12.05
| dvr3 = 1.3
| dvrv3 = 4.49
| total3 = 3.9
| totalv3 = 16.54
| title4 = [[#ep4|Shorthanded]]
| date4 = October 13, 2014
| rs4 = 2.4/6
| viewers4 = 11.51
| dvr4 = 1.2
| dvrv4 = 4.18
| total4 = 3.6
| totalv4 = 15.69
}}
|
| 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
Code
|
|---|
{{Television episode ratings
| width = 100
| fontsize = 90
| show_timeslot = y
| hide_rs = y
| hide_dvr = y
| hide_total = y
| refs_col = y
| title1 = [[#ep1|Pilot]]
| date1 = September 22, 2014
| timeslot1 = Monday 8:00 p.m.
| viewers1 = 13.83
| dvrv1 = 5.32
| totalv1 = 19.22
| ref1 = {{dummyref|1}}
| title2 = [[#ep2|Single Point of Failure]]
| date2 = September 23, 2014
| timeslot2 = Tuesday 8:00 p.m.
| timeslot_length2 = 2
| viewers2 = 13.36
| dvrv2 = 4.56
| totalv2 = 17.94
| ref2 = {{dummyref|2}}
| title3 = [[#ep3|A Cyclone]]
| date3 = September 30, 2014
| viewers3 = 12.05
| dvrv3 = 4.49
| totalv3 = 16.54
| ref3 = {{dummyref|3}}
| title4 = [[#ep4|Shorthanded]]
| date4 = October 6, 2014
| timeslot4 = Monday 8:00 p.m.
| dvrv4 = n/a
| totalv4 = n/a
| next4 = y
}}
|
| No. | Title | Air date | Timeslot (ET) | Viewers (millions) |
DVR viewers (millions) |
Total viewers (millions) |
Ref. |
|---|---|---|---|---|---|---|---|
| 1 | "Pilot" | September 22, 2014 | Monday 8:00 p.m. | 13.83 | 5.32 | 19.22 | [1] |
| 2 | "Single Point of Failure" | September 23, 2014 | Tuesday 8:00 p.m. | 13.36 | 4.56 | 17.94 | [2] |
| 3 | "A Cyclone" | September 30, 2014 | 12.05 | 4.49 | 16.54 | [3] | |
| 4–5 | "Shorthanded" | October 6, 2014 | Monday 8:00 p.m. | TBD | — | — |
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 | |