View source for Template:Episode list/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[</nowiki>[[Wikipedia:Wikidata]]<nowiki>]]) -->
{{High-use|12973}}
{{Lua|Module:Episode list}}

This template creates a [[Help:Table|table]] row, for use in a list of episodes, primarily for [[Wikipedia:Manual of Style/Television|television]]. The number, and use, of columns a table has, is defined by the beginning wikitext of that table ([[#Using the template|further explained below]]), 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 column), while excluding a parameter will not provide a cell for that field. Empty cells will be automatically filled with {{tl|TableTBA}}.

== Parameters ==
{{#ifeq: {{PAGENAME}} | Episode list/sublist | '''<nowiki>{{{MainList}}} or {{{1}}}</nowiki>''' – Title of the main ''Episode list'' article }}
{| class="wikitable plainrowheaders" style="background-color: white;"
|+ ''Episode list'' parameters and basic guidelines
! scope="col" style="background-color: whitesmoke;" | Field name
! scope="col" style="background-color: whitesmoke;" | Type
! scope="col" style="background-color: whitesmoke;" | Description
! scope="col" style="background-color: whitesmoke;" | Recommended values
|-
| '''EpisodeNumber'''
| Optional, desirable
| A number representing the episode's order in the series. For example, the first episode would be <code>1</code> or <code>01</code>, and so on. When defined, the specified number also generates a [[:Template:Anchor|link anchor]], prefixed by "<code>ep</code>"; for example, "<code><nowiki>[[List of episodes#ep1]]</nowiki></code>" or "<code><nowiki>[[List of episodes#ep01]]</nowiki></code>". In creating the anchor, the text specified for the number is treated literally: to generate the most straightforward versions of anchors as previously exemplified, specify only a number, omitting any use of [[MOS:TEXT|formatting, including bold]]. For double-episodes where two numbers are listed and are separated by <nowiki>"----", "<hr />", or "<br />"</nowiki>, the link anchor will be only the first number; that is, if the double episode spans episode numbers 87 and 88, then <code><nowiki>[[List of episodes#ep87]]</nowiki></code> will link directly to the episode.
| number - do not include additional content as this can break linking
|-
| '''EpisodeNumber2'''
| Optional
| A second episode number column. Useful for when a series aired in a different order, or only included certain episodes, etc. When used with multi-season series, this field is typically used to represent the episode's order in the season.
| number
|-
| '''Title'''
| Required
| The title of the episode. The title will appear in "quotes" when rendered, so it is not necessary to place them in quotes beforehand. Only link to an episode article if it has already been created.
| wikitext, may include links to valid articles.
|-
| '''RTitle'''
| Optional
| Unformatted parameter that can be used to add a [[WP:CITE|reference]] after "<code>Title</code>", or can be used as a "'''raw''' title" to replace "<code>Title</code>" completely. Future episodes should include a reference in this field to comply with [[Wikipedia:Verifiability]].
| wikitext, references, etc.
|-
| '''AltTitle'''
| Optional
| An alternative title, such as the title of a foreign show's episode in its native language, or a title that was originally changed. It will be listed below '''Title''' and be presented in "quotes".
| wikitext, may include links to valid articles.
|-
| '''RAltTitle'''
| Optional
| Unformatted parameter that can be used to add a [[WP:CITE|reference]] after "<code>AltTitle</code>", or can be used as a "'''raw''' title" to replace "<code>AltTitle</code>" completely.
| wikitext, references, etc.
|-
| '''Aux1'''
| Optional
| General purpose parameter. The meaning is specified by the column header.
| rowspan="5" | wikitext, may include links
|-
| '''DirectedBy'''
| Optional
| Name of the episode's director
|-
| '''WrittenBy'''
| Optional
| Primary writer(s) of the episode
|-
| '''Aux2'''
| Optional
| General purpose parameter. The meaning is specified by the column header.
|-
| '''Aux3'''
| Optional
| General purpose parameter. The meaning is specified by the column header.
|-
| '''OriginalAirDate'''
| Optional
| This is the date the episode first aired on TV, or is scheduled to air.
| date, formatted using {{tl|start date}} use {{Para|df|y}} for day-first format; omit for month-first.
|-
| '''AltDate'''
| Optional
| The next notable air date, such as the first air date of an anime in English.
| date, formatted per [[MOS:DATE]]. Do not use {{tl|start date}} if <code>OriginalAirDate</code> is present.<ref group="N">{{tl|Start date}} emits [[metadata]] as part of the parent template's [[hCalendar]] microformat. It is only needed once per episode, and may be harmful if used twice or more.</ref>
|-
| '''ProdCode'''
| Optional
| The production code in the series. When defined, this parameter also creates a link anchor, prefixed by "<code>pc</code>"; for example, "<code><nowiki>[[List of episodes#pc01]]</nowiki></code>".
| plain text
|-
| '''Viewers'''
| Optional, desirable
| Number of viewers who watched the episode. Should include a reference. The inclusion of viewer figures is supported by [[MOS:TV]] and provides encyclopaedic content beyond what might normally be found in a TV guide. It is therefore desirable to include referenced ratings information in an episode list. "Final" viewer numbers should be used.
| Number, followed by a reference.
|-
| '''Aux4'''
| Optional
| Optional parameter. The meaning is specified by the table header.
| rowspan="2" | wikitext, may include links
|-
| '''ShortSummary'''
| Optional
| {{anchor|ShortSummary}}A short 100–200 word plot summary of the episode. Make summaries specific to that episode (as in, a description that would normally not be confused with another episode). Episode summaries must not be copied from other sources, as this violates [[WP:COPYRIGHT]]. Further guidance on plot summaries may be found at [[WP:TVPLOT]]. Leaving this parameter empty will result in the summary row not appearing for this episode.
|-
| '''LineColor'''
| Optional
| Colors the separator line between episode entries. If not defined the color defaults to "<code>#CCCCFF</code>" and the article populates [[:Category:Episode list using the default LineColor]]. Use of "<code>#</code>", or anything but a valid hex code will result in an invalid syntax.
| rowspan="2" | Hex code, not preceded by "<code>#</code>". e.g. enter "<code>00ff00</code>" instead of "<code>#00ff00</code>"
|-
| '''TopColor'''
| Optional
| Colors the main row of information (that is, not the <code>ShortSummary</code> row). If not defined, it defaults to the wikitable standard background shading of "<code>#F9F9F9</code>", except when <code>ShortSummary</code> is used, and then it defaults to "<code>#f2f2f2</code>". The excessive use of the parameter is discouraged by Wikipedia's guideline on [[WP:Deviations|styles and markup options]]. Articles using this parameter are in [[:Category:Episode lists with row deviations]].
|-
| '''RowColor'''
| Optional
| This parameter is a "switch" that must only be defined when the <code>EpisodeNumber=</code> entry is not a regular number (e.g. "12–13" for two episodes described in one table entry). When [[Wikipedia:Transclusion|transcluding]] the table from a season article into a main episode list article, irregular <code>EpisodeNumber=</code> entries break up the striping effect the template introduces. If the first episode number is even, define <code>RowColor=</code> as <code>On</code>. If the first episode number is odd, define <code>RowColor=</code> as <code>Off</code>. All further uses of [[Template:Episode list]] in the table must also have the <code>RowColor=</code> parameters defined to alternate between <code>Off</code> and <code>On</code> to avoid further breakages in the striping.
| "<code>On</code>", "<code>on</code>", "<code>Yes</code>", "<code>yes</code>", "<code>Y</code>", or "<code>y</code>";<br />"<code>Off</code>", "<code>off</code>", "<code>No</code>", "<code>no</code>", "<code>N</code>", "<code>n</code>"
|}

This is where information from the template is placed when rendered (''{{para|LineColor}}, {{para|TopColor}}, and {{para|RowColor}} are not shown, since there's no text to display''):
{| class="wikitable plainrowheaders" style="width: 100%; margin: auto; background: #FFFFFF; font-size:0.8em;"
|-
<tr class="vevent" style="text-align: center; background:#F2F2F2">
<th scope="row" style="text-align: center; background:#F2F2F2"><nowiki>{{{EpisodeNumber}}}</nowiki></th>
<td><nowiki>{{{EpisodeNumber2}}}</nowiki></td>
<td class="summary" style="text-align: left;">{{nowrap|"<nowiki>{{{Title}}}</nowiki>"<nowiki>{{{RTitle}}}</nowiki>}} <br />{{nowrap|"<nowiki>{{{AltTitle}}}</nowiki>"<nowiki>{{{RAltTitle}}}</nowiki>}}</td>
<td><nowiki>{{{Aux1}}}</nowiki></td>
<td><nowiki>{{{DirectedBy}}}</nowiki></td>
<td><nowiki>{{{WrittenBy}}}</nowiki></td>
<td><nowiki>{{{Aux2}}}</nowiki></td>
<td><nowiki>{{{Aux3}}}</nowiki></td>
<td><nowiki>{{{OriginalAirDate}}}</nowiki></td>
<td><nowiki>{{{AltDate}}}</nowiki></td>
<td><nowiki>{{{ProdCode}}}</nowiki></td>
<td><nowiki>{{{Viewers}}}</nowiki></td>
<td><nowiki>{{{Aux4}}}</nowiki></td></tr>
<tr><td class="description" style="border-bottom:3px solid #CCCCFF" colspan="13">
<nowiki>{{{ShortSummary}}}</nowiki>&nbsp;</td></tr>
|}


===TemplateData===
{{TemplateDataHeader}}
<templatedata>
{
	"params": {
		"EpisodeNumber": {
			"label": "Episode number",
			"description": "A number representing the episode's order in the series. For example, the first episode would be 1 or 01, and so on. When defined, the specified number also generates a link anchor, prefixed by \"ep\"; for example, \"[[List of episodes#ep1]]\" or \"[[List of episodes#ep01]]\". In creating the anchor, the text specified for the number is treated literally: to generate the most straightforward versions of anchors as previously exemplified, specify only a number, omitting any use of formatting, including bold. For double-episodes where two numbers are listed and are separated by \"----\", \"<hr />\", or \"<br />\", the link anchor will be only the first number; that is, if the double episode spans episode numbers 87 and 88, then [[List of episodes#ep87]] will link directly to the episode.",
			"type": "number",
			"suggested": true
		},
		"EpisodeNumber2": {
			"label": "Second episode number",
			"description": "A second episode number column. Useful for when a series aired in a different order, or only included certain episodes, etc. When used with multi-season series, this field is typically used to represent the episode's order in the season.",
			"type": "number"
		},
		"Title": {
			"label": "Title",
			"description": "The title of the episode. The title will appear in \"quotes\" when rendered, so it is not necessary to place them in quotes beforehand. Only link to an episode article if it has already been created.",
			"type": "content",
			"required": true
		},
		"RTitle": {
			"label": "Title reference, or title (raw)",
			"description": "Unformatted parameter that can be used to add a reference after \"Title\", or can be used as a \"raw title\" to replace \"Title\" completely. Future episodes should include a reference in this field to comply with Wikipedia:Verifiability.",
			"type": "content"
		},
		"AltTitle": {
			"label": "Alternative title",
			"description": "An alternative title, such as the title of a foreign show's episode in its native language, or a title that was originally changed. It will be listed below Title and be presented in \"quotes\".",
			"type": "content"
		},
		"RAltTitle": {
			"label": "Alternative title's reference, or alternative title (raw)",
			"description": "Unformatted parameter that can be used to add a reference after \"AltTitle\", or can be used as a \"raw title\" to replace \"AltTitle\" completely.",
			"type": "content"
		},
		"Aux1": {
			"label": "Extra column 1",
			"description": "Unformatted parameter that can be used to add a reference after \"AltTitle\", or can be used as a \"raw title\" to replace \"AltTitle\" completely.",
			"type": "content"
		},
		"DirectedBy": {
			"label": "Directed by",
			"description": "Name of the episode's director. May contain links.",
			"type": "content"
		},
		"WrittenBy": {
			"label": "Written by",
			"description": "Primary writer(s) of the episode. May include links.",
			"type": "content"
		},
		"Aux2": {
			"label": "Extra column 2",
			"description": "General purpose parameter. The meaning is specified by the column header.",
			"type": "content"
		},
		"Aux3": {
			"label": "Extra column 3",
			"description": "General purpose parameter. The meaning is specified by the column header.",
			"type": "content"
		},
		"OriginalAirDate": {
			"label": "Original air date",
			"description": "This is the date the episode first aired on TV, or is scheduled to air. formatted using {{start date}} use |df=y for day-first format; omit for month-first."
		},
		"AltDate": {
			"label": "Second notable air date",
			"description": "The next notable air date, such as the first air date of an anime in English. Formatted per MOS:DATE. Do not use {{start date}} if OriginalAirDate is present."
		},
		"ProdCode": {
			"label": "Production code",
			"description": "The production code in the series. When defined, this parameter also creates a link anchor, prefixed by \"pc\"; for example, \"[[List of episodes#pc01]]\".",
			"type": "string"
		},
		"Viewers": {
			"label": "Number of viewers",
			"description": "Number of viewers who watched the episode. Should include a reference. The inclusion of viewer figures is supported by MOS:TV and provides encyclopaedic content beyond what might normally be found in a TV guide. It is therefore desirable to include referenced ratings information in an episode list. \"Final\" viewer numbers should be used.",
			"type": "content",
			"suggested": true
		},
		"Aux4": {
			"label": "Extra column 4",
			"description": "General purpose parameter. The meaning is specified by the column header.",
			"type": "content"
		},
		"ShortSummary": {
			"label": "Short summary",
			"description": "A short 100–200 word plot summary of the episode. Make summaries specific to that episode (as in, a description that would normally not be confused with another episode). Episode summaries must not be copied from other sources, as this violates WP:COPYRIGHT. Further guidance on plot summaries may be found at WP:TVPLOT. Leaving this parameter empty will result in the summary row not appearing for this episode.",
			"type": "content"
		},
		"LineColor": {
			"label": "Border color",
			"description": "Not usually needed. Colors the separator line between episode entries. If not defined the color defaults to \"#CCCCFF\" and the article populates Category:Episode list using the default LineColor. Use of \"#\", or anything but a valid hex code will result in an invalid syntax.",
			"example": "\"00ff00\" is bright green.",
			"type": "string"
		},
		"TopColor": {
			"label": "Top color",
			"description": "Colors the main row of information (that is, not the ShortSummary row).  The excessive use of the parameter is discouraged by Wikipedia's guideline on styles and markup options. Articles using this parameter are in Category:Episode lists with row deviations.",
			"example": "\"00ff00\" is bright green.",
			"type": "string",
			"default": "If not defined, it defaults to the wikitable standard background shading of \"#F9F9F9\", except when ShortSummary is used, and then it defaults to \"#f2f2f2\"."
		},
		"RowColor": {
			"label": "Row banding color override",
			"description": "This parameter is a \"switch\" that must only be defined when the EpisodeNumber= entry is not a regular number (e.g. \"12–13\" for two episodes described in one table entry). When transcluding the table from a season article into a main episode list article, irregular EpisodeNumber= entries break up the striping effect the template introduces. If the first episode number is even, define RowColor= as On. If the first episode number is odd, define RowColor= as Off. All further uses of Template:Episode list in the table must also have the RowColor= parameters defined to alternate between Off and On to avoid further breakages in the striping.",
			"example": "\"On\", \"on\", \"Yes\", \"yes\", \"Y\", or \"y\"; \"Off\", \"off\", \"No\", \"no\", \"N\", \"n\"",
			"type": "boolean"
		}
	},
	"description": "This template creates a table row, for use in a list of episodes, primarily for television. The number, and use, of columns a table has, is defined by the beginning wikitext of that table (further explained below), 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 column), while excluding a parameter will not provide a cell for that field. Empty cells will be automatically filled with {{TableTBA}}. It is used within {{Episode table}}.",
	"paramOrder": [
		"EpisodeNumber",
		"EpisodeNumber2",
		"Title",
		"RTitle",
		"AltTitle",
		"RAltTitle",
		"Aux1",
		"DirectedBy",
		"WrittenBy",
		"Aux2",
		"Aux3",
		"OriginalAirDate",
		"AltDate",
		"ProdCode",
		"Viewers",
		"Aux4",
		"ShortSummary",
		"LineColor",
		"TopColor",
		"RowColor"
	]
}
</templatedata>

== Using the template ==
When using optional parameters (such as <code>Aux1</code> or <code>AltDate</code>) only list the parameters that are being used, and adjust the table headers accordingly. This will help avoid confusion when one entry has a parameter filled out, and another does not. A table cell will be open for each listed parameter, whether it is filled out or not. Empty cells will be automatically filled with {{tl|TableTBA}}.

To apply an entry to an episode listing, add this template where the episode would go in the '''List of episodes'''. The full syntax is as follows (remove the parameters that are not being used in the table):
<pre>
{{Episode list
| EpisodeNumber   = 
| EpisodeNumber2  = 
| Title           = 
| RTitle          = 
| AltTitle        = 
| RAltTitle       = 
| 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       = 
}}
</pre>

Because this is only part of a [[WP:TABLE|WikiTable]], you must first create the "header" of the WikiTable. To do so, you should use {{tl|Episode table}}. Please refer to [[Template:Episode table/doc|that template's documentation]] for an in-depth description of how to use each of its parameters. An example here, to create a list with only <code>EpisodeNumber</code>, <code>Title</code>, <code>OriginalAirDate</code>, <code>ProdCode</code>, and <code>ShortSummary</code> parameters, open the table as follows:
<pre>
{{Episode table |overall= |title= |airdate= |prodcode= |episodes=
</pre>

The {{tl|Episode list}} templates would then follow here:
<pre>
{{Episode list
| EpisodeNumber   = 1
| Title           = Reborn
| OriginalAirDate = {{start date|1998|09|21}}
| ProdCode        = 98101-201
| ShortSummary    = Immortal thief Amanda is followed by detectives Nick Wolfe and Claudia Hoffmann.
}}
{{Episode list
| EpisodeNumber   = 2
| Title           = Full Disclosure
| OriginalAirDate = {{start date|1998|09|28}}
| ProdCode        = 98102-202
| ShortSummary    = Wolfe and Amanda cannot prevent Navajo code talker Walter from being killed.
}}
</pre>

After the final episode list template, you will close the {{tl|Episode table}} with:
<pre>
}}
</pre>

=== Examples ===
The above code would appear as follows:
{{Episode table |overall= |title= |airdate= |prodcode= |episodes=
{{Episode list
| EpisodeNumber   = 1
| Title           = Reborn
| OriginalAirDate = {{start date|1998|09|21}}
| ProdCode        = 98101-201
| ShortSummary    = Immortal thief Amanda is followed by detectives Nick Wolfe and Claudia Hoffmann.
}}
{{Episode list
| EpisodeNumber   = 2
| Title           = Full Disclosure
| OriginalAirDate = {{start date|1998|09|28}}
| ProdCode        = 98102-202
| ShortSummary    = Wolfe and Amanda cannot prevent Navajo code talker Walter from being killed.
}}
}}

A more complex case would look like the following:
<pre>
{{Episode table |background=#812f09 |overall= |season= |title= |director= |writer= |aux2= |aux2T=Ben's location |airdate= |prodcode= |viewers= |country=U.S. |episodes=
{{Episode list
| 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
| 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
}}
}}
</pre>

{{Episode table |background=#812f09 |overall= |season= |title= |director= |writer= |aux2= |aux2T=Ben's location |airdate= |prodcode= |viewers= |country=U.S. |episodes=
{{Episode list
| 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
| 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
}}
}}

== Sublists ==
Occasionally, when dealing with a very long series, you may wish to break the list up into separate sublists, generally broken by season or years. See [[Wikipedia:Manual of Style/Television#Multiple pages]] for more info regarding when to split.

The name of the sublist should correspond with the article title where the episode table is located. For example, if you were working on [[List of Lost episodes]], you would split it into [[Lost (season 1)]] and [[Lost (season 2)]], and each episode on the sublist would use {{tld|Episode list/sublist|Lost (season 1)}} and {{tld|Episode list/sublist|Lost (season 2)}} respectively.

When transcluded onto any other article, this template removes any summaries, and alternates the background row color between light and dark gray, depending on the value of {{para|EpisodeNumber}}. Occasionally, a multi-part episode will skew the pattern between odd and even <code>EpisodeNumber</code>s, to rectify this, use the <code>RowColor</code> parameter. A "<code>On</code>" input will color the row dark gray, like an even number normally would, on the "List of ''X'' episodes" page, while a "<code>Off</code>" input will color the row light gray, like an odd number normally would.

For the purpose of transclusion, each sublist must make use of <code>&lt;onlyinclude></code> 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 {{tl|main}}. For example, referring to ''[[Lost (TV series)|Lost]]'' again, the main list would have the following code under the "Episode list" header:
<pre>
== 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. -->
</pre>

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 {{Lost (season 1)}}, a redlink to a nonexistent template.

=== Examples ===
If the following code is on [[Lost (season 3)|''Lost'' (season 3)]]:
<pre>
&lt;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&lt;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&lt;ref name="viewers"/>
| ShortSummary    = Jack learns of the Others' plan.
| LineColor       = 2E5528
}}
{{Episode list/sublist|Lost (season 3)
| RowColor        = N
| EpisodeNumber   = 71–72
| EpisodeNumber2  = 22–23
| Title           = Through the Looking Glass
| DirectedBy      = Jack Bender
| WrittenBy       = Carlton Cuse & Damon Lindelof
| Aux2            = Jack
| OriginalAirDate = {{Start date|2007|5|23}}
| Viewers         = 13.86&lt;ref name="viewers"/>
| ShortSummary    = Sayid, Jin, and Bernard are held hostage by the Others at the beach.
| LineColor       = 2E5528
}}
}}&lt;/onlyinclude>
</pre>

If the following code is on [[Lost (season 4)|''Lost'' (season 4)]]:
<pre>
&lt;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)
| RowColor        = Y
| 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&lt;ref name="rankings"/>
| ShortSummary    = The survivors of 815 split into two groups led by Jack and Locke.
| LineColor       = 00549A
}}
{{Episode list/sublist|Lost (season 4)
| RowColor        = N
| 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&lt;ref name="rankings"/>
| ShortSummary    = A science team from the freighter arrives on the island.
| LineColor       = 00549A
}}
{{Episode list/sublist|Lost (season 4)
| RowColor        = Y
| EpisodeNumber   = 75
| EpisodeNumber2  = 3
| Title           = The Economist
| RTitle          = &lt;ref name="episode titles"/>
| DirectedBy      = 
| WrittenBy       = 
| Aux2            = 
| OriginalAirDate = {{Start date|2008|2|14}}&lt;ref name="TV Guide"/>
| Viewers         = 
| ShortSummary    = Locke's group settles into the Barracks.&lt;ref name="TV Guide"/>
| LineColor       = 00549A
}}
|}&lt;/onlyinclude>
</pre>

And if the following code is on [[List of Lost episodes|List of ''Lost'' episodes]]:
<pre>
== Season 3 ==
{{main|Lost (season 3)}}
{{:Lost (season 3)}}
<!-- To edit the episodes in this section, you need to edit the article listed above. -->

== Season 4 ==
{{main|Lost (season 4)}}
{{:Lost (season 4)}}
<!-- To edit the episodes in this section, you need to edit the article listed above. -->
</pre>

List of ''Lost'' episodes will appear as follows:
;Season 3
{{main|Lost (season 3)}}
{{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{{dummy ref}}
| 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{{dummy ref}}
| ShortSummary    = Jack learns of the Others' plan.
| LineColor       = 2E5528
}}
{{Episode list/sublist|Lost (season 3)
| RowColor        = N
| EpisodeNumber   = 71–72
| EpisodeNumber2  = 22–23
| Title           = Through the Looking Glass
| DirectedBy      = Jack Bender
| WrittenBy       = Carlton Cuse & Damon Lindelof
| Aux2            = Jack
| OriginalAirDate = {{Start date|2007|5|23}}
| Viewers         = 13.86{{dummy ref}}
| ShortSummary    = Sayid, Jin, and Bernard are held hostage by the Others at the beach.
| LineColor       = 2E5528
}}
}}
<!-- To edit the episodes in this section, you need to edit the article listed above. -->

;Season 4
{{main|Lost (season 4)}}
{{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)
| RowColor        = Y
| 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{{dummy ref|2}}
| ShortSummary    = The survivors of 815 split into two groups led by Jack and Locke.
| LineColor       = 00549A
}}
{{Episode list/sublist|Lost (season 4)
| RowColor        = N
| 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{{dummy ref|2}}
| ShortSummary    = A science team from the freighter arrives on the island.
| LineColor       = 00549A
}}
{{Episode list/sublist|Lost (season 4)
| RowColor        = Y
| EpisodeNumber   = 75
| EpisodeNumber2  = 3
| Title           = The Economist
| RTitle          = {{dummy ref|3}}
| DirectedBy      = 
| WrittenBy       = 
| Aux2            = 
| OriginalAirDate = {{Start date|2008|2|14}}{{dummy ref|4}}
| Viewers         = 
| ShortSummary    = Locke's group settles into the Barracks.{{dummy ref|4}}
| LineColor       = 00549A
}}
}}
<!-- To edit the episodes in this section, you need to edit the article listed above. -->

== Tips ==
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:

<pre>==Episodes==
<nowiki><!-- For help with this template see http://en.wikipedia.org/wiki/Template:Episode_list --></nowiki>
&lt;onlyinclude>
{{Episode table
</pre>

This message won't be visible when normally viewing the article. A message such as this notes where one can get help for the template.

== Microformat ==
{{UF-hcal-multi}}
For shows where each episode is from a different, single, specific place (for example, [[Time Team]], one of the ''Aux'' fields can contain the [[Geographic coordinate system|coordinates]], applied using {{tl|coord}}.

== Subpages ==
{{Special:PrefixIndex/Template:Episode list}}

"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.

== Episode list templates ==
* [[Wikipedia:WikiProject Television/Episode lists]]
* [[Template:Episode list]]
* [[Template:Japanese episode list]]
* [[Template:Television needs episode list]]

== See also ==
* {{tl|Episode table}}
* {{tl|Infobox television}}
* {{tl|Infobox television season}}
* {{tl|Infobox television episode}}
* [[Wikipedia:WikiProject Television#More television templates]]

== Notes ==
{{Reflist|group="N"}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Television episode list templates| ]]
}}</includeonly>