Episode list creates a table row, for use in a list of episodes tables, primarily for television. This template can be used in conjunction with {{Episode table}} which creates a consistent and Manual of Style ready table, or with a manually created table. See walk-through for further explanation.
{{Episode list}} may be added by pasting it as shown below into an article, either inside an {{Episode table}} template, or be placed inside a manually created table. The number and the type of columns a table has, is defined by the table header, and is not defined by this template. In order for this template to provide a table column for a given episode, parameters must either be included or excluded. An included parameter, although empty, will provide a cell for that field (and thus a column), while excluding a parameter will not provide a cell for that field. Empty cells will be automatically filled with "TBA" or "N/A".
.svg/1280px-Test_Template_Info-Icon_-_Version_(2).svg.png){kind=icon}
{{Episode list| EpisodeNumber = | EpisodeNumber2 = | Title = | RTitle = | AltTitle = | RAltTitle = | TranslitTitle = | NativeTitle = | NativeTitleLangCode = | Aux1 = | DirectedBy = | WrittenBy = | Aux2 = | Aux3 = | OriginalAirDate = <!-- {{Start date|YYYY|MM|DD|df=}} -->| AltDate = | ProdCode = | Viewers = | Aux4 = | ShortSummary = <!-- Don't add copyrighted text, e.g. from the show's website -->| LineColor = | TopColor = | RowColor = }}To create an episode list, first create the table columns with the use of {{Episode table}} as following:
{{Episode table |overall= |title= |airdate= |prodcode= |episodes=Be mindful that |episodes= has been included as the final parameter of {{Episode table}} for the individual {{Episode list}} templates to appear, as excluding it can cause lint errors.
Next, add the {{Episode list}} templates below:
{{Episode list| EpisodeNumber = | Title = | OriginalAirDate = | ProdCode = | ShortSummary = }}{{Episode list| EpisodeNumber = | Title = | OriginalAirDate = | ProdCode = | ShortSummary = }}Lastly, after the final episode list template, close the {{Episode table}} with:
}}
The complete code will look like this:
{{Episode table |overall= |title= |airdate= |prodcode= |episodes={{Episode list| EpisodeNumber = | Title = | OriginalAirDate = | ProdCode = | ShortSummary = }}{{Episode list| EpisodeNumber = | Title = | OriginalAirDate = | ProdCode = | ShortSummary = }}}}To create an episode list with the columns: episode number in series, episode number in season, title, director, writer, show-specific parameter, air date, production code and number of U.S. viewers – add the following code:
{{Episode table |background=#812f09 |overall= |season= |title= |director= |writer= |aux2= |aux2T=Ben's location |airdate= |prodcode= |viewers= |country=U.S. |episodes={{Episode list/sublist|List of Carnivàle episodes| EpisodeNumber = 1| EpisodeNumber2 = 1| Title = Milfay| DirectedBy = [[Rodrigo García (director)|Rodrigo García]]| WrittenBy = [[Daniel Knauf]]| Aux2 = [[Milfay, Oklahoma]]| OriginalAirDate = {{Start date|2003|9|14}}| ProdCode = 1–01| Viewers = 5.3| ShortSummary = Ben suffers strange dreams about a trench war, and a tattooed man stalking in a cornfield.| LineColor = 812f09}}{{Episode list/sublist|List of Carnivàle episodes| EpisodeNumber = 2| EpisodeNumber2 = 2| Title = After the Ball Is Over| DirectedBy = [[Jeremy Podeswa]]| WrittenBy = Daniel Knauf| Aux2 = [[Tipton, Missouri]]| OriginalAirDate = {{Start date|2003|9|21}}| ProdCode = 1–02| Viewers = 3.49| ShortSummary = Ben is slowly setting in as a carnival roustabout.| LineColor = 812f09}}}}To create an episode list which includes a native title and/or transliterated title – add the following code:
{{Episode table |background=#0C5829 |overall= |overallT=Japanese episode {{abbr|no.|number}} |season= |seasonT=U.S. episode {{abbr|no.|number}} |title= |director= |writer= |airdate= |episodes={{Episode list/sublist|List of Pokémon: Indigo League episodes| EpisodeNumber = 1| EpisodeNumber2 = 1| Title = [[Pokémon, I Choose You!]]| RTitle = (Pokémon I Choose You!)| TranslitTitle = Pokemon! Kimi ni Kimeta!| NativeTitle = ポケモン! きみにきめた!| NativeTitleLangCode = ja| DirectedBy = Masamitsu Hidaka| WrittenBy = [[Shoji Yonemura]]| OriginalAirDate = {{Start date|1997|4|1}}| ShortSummary = Ash Ketchum is finally 10 years old, old enough to become a Pokémon Trainer. | LineColor = #0C5829}}}}To create an episode list which includes an episode with multiple titles – add the following code:
{{Episode table |background=#69D0E3 |overall= |title= |airdate= |episodes={{Episode list/sublist|Ninja Nonsense| NumParts = 2| EpisodeNumber = 1| Title_1 = Shinobu, the Ninja Apprentice, Appears| TranslitTitle_1 = Minarai Ninja, Shinobu Kenzan no Maki| NativeTitle_1 = 見習い忍者、忍見参の巻| Title_2 = The Master Appears| TranslitTitle_2 = Tōryō, Arawaru no Maki| NativeTitle_2 = 頭領、現るの巻| NativeTitleLangCode = ja| OriginalAirDate = {{Start date|2004|7|8}}| ShortSummary = Episode summary| LineColor = #69D0E3}}}}To create an episode list for a serial (such as those used in Doctor Who) – add the following code:
{{Episode table|background = #8D3D63 |overall= |overallT=Story |series= |seriesT=Serial |title= |aux1= |aux1T=Serial titles |director= |writer= |airdate= |prodcode= |viewers= |country=UK |aux4= |aux4T=[[Appreciation Index|{{abbr|AI|Appreciation Index|style=color:white}}]] |episodes ={{Episode list/sublist|Doctor Who (season 1)| NumParts = 4| EpisodeNumber = 1| EpisodeNumber2 = 1| Title = [[An Unearthly Child]]| Aux1_1 = "An Unearthly Child"| Aux1_2 = "The Cave of Skulls"| Aux1_3 = "The Forest of Fear"| Aux1_4 = "The Firemaker"| DirectedBy = [[Waris Hussein]]| WrittenBy = [[Anthony Coburn]]| OriginalAirDate_1 = {{Start date|1963|11|23|df=y}}| OriginalAirDate_2 = 30 November 1963| OriginalAirDate_3 = 7 December 1963| OriginalAirDate_4 = 14 December 1963| ProdCode = A| Viewers_1 = 4.4| Viewers_2 = 5.9| Viewers_3 = 6.9| Viewers_4 = 6.4| Aux4_1 = 63| Aux4_2 = 59| Aux4_3 = 56| Aux4_4 = 55| ShortSummary = Schoolteachers [[Ian Chesterton]] and [[Barbara Wright (Doctor Who)|Barbara Wright]] are concerned about one of their pupils, [[Susan Foreman]].| LineColor = 8D3D63}}}}When a TV series article is split into season pages, create each season's episode list on the corresponding season article. If the series also has a "List of episodes" article, do not re-create the tables in it, and instead transclude the table from the season articles to the list of episodes article.
Use {{Episode list}} for episode tables and lists that are not transcluded to any other article. Use {{Episode list/sublist|[article name]}} for episode tables and lists that are transcluded to another article, such as a list of episodes article, or the parent series article, where "[article name]" is the name of the article the episode lists exists on and is transcluded from.
For example, the TV series Lost has season articles for each of its seasons. An episode table is located in each of its season articles, such as Lost (season 1) and Lost (season 2). Each season is then transcluded to List of Lost episodes.
For the purpose of transclusion, each sublist must make use of <onlyinclude> tags, with the opening tag just before the WikiTable, and the closing tag at the very end of the table. This prevents the lead, external links, templates, categories, interwiki links, and all other unnecessary information from being transcluded onto the main list.
When transcluding onto the main list, you should make use of {{Main}}.
On a season article, such as Lost (season 3), the code should be as follows:
<onlyinclude>{{Episode table |background=#2E5528 |overall= |season= |title= |director= |writer= |aux2= |aux2T=Featured<br />character(s) |airdate= |viewers= |country=U.S. |episodes={{Episode list/sublist|Lost (season 3)| EpisodeNumber = 69| EpisodeNumber2 = 20| Title = The Man Behind the Curtain| DirectedBy = [[Bobby Roth]]| WrittenBy = Elizabeth Sarnoff & Drew Goddard| Aux2 = [[Ben Linus|Ben]]| OriginalAirDate = {{Start date|2007|5|9}}| Viewers = 12.11<ref name="viewers"/>| ShortSummary = Locke meets the Others' mysterious leader Jacob.| LineColor = 2E5528}}{{Episode list/sublist|Lost (season 3)| EpisodeNumber = 70| EpisodeNumber2 = 21| Title = Greatest Hits| DirectedBy = Stephen Williams| WrittenBy = Edward Kitsis & Adam Horowitz| Aux2 = [[Charlie Pace|Charlie]]| OriginalAirDate = {{Start date|2007|5|16}}| Viewers = 12.32<ref name="viewers"/>| ShortSummary = Jack learns of the Others' plan.| LineColor = 2E5528}}}}</onlyinclude>And similar for the other season articles of the series, such as Lost (season 4):
<onlyinclude>{{Episode table |background=#00549A |overall= |season= |title= |director= |writer= |aux2= |aux2T=Featured<br />character(s) |airdate= |viewers= |country=U.S. |episodes={{Episode list/sublist|Lost (season 4)| EpisodeNumber = 73| EpisodeNumber2 = 1| Title = The Beginning of the End| DirectedBy = [[Jack Bender]]| WrittenBy = [[Damon Lindelof]] & [[Carlton Cuse]]| Aux2 = [[Hugo "Hurley" Reyes|Hurley]]| OriginalAirDate = {{Start date|2008|1|31}}| Viewers = 17.77<ref name="rankings"/>| ShortSummary = The survivors of 815 split into two groups led by Jack and Locke.| LineColor = 00549A| RowColor = on}}{{Episode list/sublist|Lost (season 4)| EpisodeNumber = 74| EpisodeNumber2 = 2| Title = Confirmed Dead| DirectedBy = [[Stephen Williams (director)|Stephen Williams]]| WrittenBy = [[Drew Goddard]] & [[Brian K. Vaughan]]| Aux2 = [[Daniel Faraday|Faraday]]| OriginalAirDate = {{Start date|2008|2|7}}| Viewers = 16.96<ref name="rankings"/>| ShortSummary = A science team from the freighter arrives on the island.| LineColor = 00549A| RowColor = off}}|}</onlyinclude>The following code should appear on List of Lost episodes:
== Season 1 =={{Main|Lost (season 1)}}{{:Lost (season 1)}}<!-- To edit the episodes in this section, you need to edit the article listed above. -->== Season 2 =={{main|Lost (season 2)}}{{:Lost (season 2)}}<!-- To edit the episodes in this section, you need to edit the article listed above. -->Note the colon (:) at the beginning of the transclusions; this is necessary when transcluding an article. If you tried to transclude Lost (season 1), without using the colon, you would get Template:Lost (season 1), a redlink to a nonexistent template.
The above code will appear as follows:
It may be helpful to include a hidden message that will appear when someone edits the article. Placed above the table headers and under the article section, such as:
==Episodes==<!-- For help with this template see https://en.wikipedia.org/wiki/Template:Episode_list/Template:Episode_list --><onlyinclude>{{Episode tableThis message won't be visible when normally viewing the article. A message such as this notes where one can get help for the template.
The HTML markup produced by this template includes an hCalendar microformat, which makes the event details parsable by computers, either acting automatically to catalogue article across Wikipedia, or via a browser tool operated by a person, to (for example) add the subject to a calendar or diary application. For more information about the use of microformats on Wikipedia, please see the microformat project.
Dates will only be included if you use {{Start date}} or {{End date}} (use the former for single dates). As an alternative, you may use {{Start-date}} and {{End-date}}.
hCalendar uses HTML classes including:
Please do not rename or remove these classes; nor collapse nested elements which use them.
Pages which use multiple instances of this template can also use {{UF-timeline}}, in their external links section, to generate a SIMILE timeline. It renders as:
For shows where each episode is from a different, single, specific place (for example, Time Team, one of the Aux fields can contain the coordinates, applied using {{coord}}.
"Hacks" of this template, also known as "forks", are discouraged. Any discussion regarding forks should occur on this template's, not the fork's or article's, talk page.
{{WikiProject Television|needs-episode-list=yes}}