Template:Television episode ratings
Usage[edit source]
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[edit source]
<syntaxhighlight lang="wikitext">
| No. | Series | Air date | Timeslot (ET) | Template:Ref heading |
|---|
Examples[edit source]
Basic example[edit source]
Template:Collapse top <syntaxhighlight lang="wikitext">
| 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 |
| 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[edit source]
Hiding columns, Width, Font size, Timeslot, TBD & N/A cells, References, Multiple episodes Template:Collapse top <syntaxhighlight lang="wikitext">
| 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 | — | — |
| 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[edit source]
| 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 | |