View source for Template:Infobox television episode/doc

{{Documentation subpage}}
{{high-use|10837}}
{{Auto short description}}
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Check for unknown parameters|Module:Television episode short description}}

'''Infobox television episode''' is used to create an [[WP:Infobox|infobox]] which summarizes the main information of a particular television episode or internet video.

== Usage ==
The infobox may be added by pasting the template as shown below into an article, typically at the top of an article above the lead section. This infobox creates a [[WP:Short description|short description]] based on the data provided to the infobox. For more information on this, see the documentation at [[Template:Television episode short description]].

{{Infobox television episode
| title          = {{{title}}}
| series         = {{{series}}}
| image          = {{{image}}}
| image_size     = {{{image_size|}}}
| image_alt      = {{{image_alt}}}
| caption        = {{{caption}}}
| season         = {{{season}}}
| series_no      = {{{series no}}}
| episode        = {{{episode}}}
| director       = {{{director}}}
| writer         = {{{writer}}}
| story          = {{{story}}}
| teleplay       = {{{teleplay}}}
| based_on       = {{{based_on}}}
| narrator       = {{{narrator}}}
| presenter      = {{{presenter}}}
| producer       = {{{producer}}}
| music          = {{{music}}}
| photographer   = {{{photographer}}}
| editor         = {{{editor}}}
| production     = {{{production}}}
| airdate        = {{{airdate}}}
| length         = {{{length}}}
| awards         = {{{awards}}}
| guests         = {{{guests}}}
| prev           = {{{prev}}}
| next           = {{{next}}}
| season_article = {{{season_article}}}
| episode_list   = {{{episode_list}}}
}}
<section begin=infobox /><pre style="width:auto; overflow:auto">
{{Infobox television episode
| title          = 
| series         = <!-- without italics or formatting. Wikilinking optional. -->
| image          = <!-- bare filename only. Wikilinking, "File:", and pixel size not required. -->
| image_size     = <!-- raw number. "px" not required. -->
| image_alt      = 
| caption        = 
| season         = 
| series_no      = 
| episode        = 
| director       = 
| writer         = 
| story          = 
| teleplay       = 
| based_on       = 
| narrator       = 
| presenter      = 
| producer       = 
| music          = 
| photographer   = 
| editor         = 
| production     = 
| airdate        = <!-- {{Start date|YYYY|MM|DD}} -->
| length         = 
| awards         = 
| guests         = 
| prev           = 
| next           = 
| season_article = 
| episode_list   = 
}}
</pre><section end=infobox />
{{clear}}

== Parameters ==
Link people only if they have articles. For most of the fields below, if there are multiple entries, separate them using {{tl|Plainlist}} or {{tl|Unbulleted list}}. When adding data to fields, do not use small text as this reduces the size of the text to below 85% of the page font size. See [[Wikipedia:Manual of Style/Accessibility#Text]] for more information.

{| class="wikitable"
|+Template parameters
! scope="col" | Parameter
! scope="col" | Explanation
|-
! scope="row" | child
| An optional parameter make this a child infobox.
|-
! scope="row" | no_italic
| Any value will display the automatic italicization of the series name in the parenthesis. This parameter should not be used most of the time.
|-
! scope="row" | {{Unbulleted list|title|RTitle}}
| The title of the episode. The title is automatically put within quotation marks, unless RTitle is used.
|-
! scope="row" | series
| The name of the [[TV series]] this episode is part of, with a link to the series' main article. Series name is automatically italicized.
|-
! scope="row" | not_dab
| A parameter that is used when the series name has parenthesis which are part of the title, such as [[Randall and Hopkirk (Deceased)]].
|-
! scope="row" | image
| An image, if needed. Wikilinking, "File:", and pixel size not required. Remember, virtually all TV screenshots are copyrighted, so they must be low resolution, and be accompanied by a fair-use rationale. '''There is no blanket allowance for an image per episode'''. A non-free screenshot should be used only if it meets the ''[[Wikipedia:Non-free content criteria]]'', i.e. typically if it is required to illustrate a crucial element of the episode that is the object of explicit, sourced analytical commentary and where that commentary is in genuine need of visual support.
|-
! scope="row" | image_size
| Image size in pixels. Should be 250 or less. If not specified, image defaults to frameless (220px). "px" is not required.
|-
! scope="row" | image_alt
| Alt text for image per [[WP:MOSALT]].
|-
! scope="row" | caption
| A caption explaining the image.
|-
! scope="row" | {{Unbulleted list|season|series_no}}
| The number of the season (or series) this episode is part of. Use either <code>season</code> or <code>series_no</code>, but not both. Typically, "series" is used for television series produced within the United Kingdom while "season" is used for American television series.
|-
! scope="row" | episode
| The number of the episode within the season or series ("series" as used in previous parameter).
|-
! scope="row" | multi_episodes
| A parameter to alter select wording of the infobox when used for multi-part episodes with the same title.
|-
! scope="row" | director
| The [[Film director|director(s)]] of this episode. Separate multiple people using {{Tl|Plainlist}}. In addition, link each director to their appropriate article if possible.
|-
! scope="row" | writer
| The [[writer]](s) of this episode. Separate multiple people using {{Tl|Plainlist}}. In addition, link each writer to their appropriate article if possible.
|-
! scope="row" | story
| The writer(s) of the episode's story. Separate multiple people using {{Tl|Plainlist}}. Use this field instead of the normal writer field if television episodes divide writing credits between teleplay and story writers.
|-
! scope="row" | teleplay
| The writer(s) of the episode's teleplay. Separate multiple people using {{Tl|Plainlist}}. Use this field instead of the normal writer field if television episodes divide writing credits between teleplay and story writers.
|-
! scope="row" | based_on
| The original work the episode is based on. Use {{Tl|based on}} to add the title of the source material and the name(s) of the source material writer(s). Use this field in conjunction with teleplay and story where applicable. This field should be used if the episode is based on previously produced or published material, such as books, plays, articles, old screenplays, etc. and should not be used where the source material is ambiguous. This field should not be used for general adaptations, such as [[The Flash (2014 TV series)|''The Flash'']] episodes being based on characters from DC Comics, however, do use it if a specific episode of that series is a direct adaptation of a specific comic.
|-
! scope="row" | narrator
| The [[Narration|narrator(s)]] of this episode. Separate multiple people using {{Tl|Plainlist}}. In addition, link each narrator to their appropriate article if possible.
|-
! scope="row" | presenter
| The person who fronts (hosts) the show.
|-
! scope="row" | producer
| The [[Film producer|producer(s)]] of this episode. As television episodes typically have several credited producers, not all of whom had a direct role in the production of the episode, it is advisable to just include the [[show runner]](s). Separate multiple people using {{Tl|Plainlist}}.  In addition, link each producer to their appropriate article if possible.
|-
! scope="row" | music
| The music of this episode. Separate multiple songs using {{Tl|Plainlist}}. Television episodes often include numerous songs; only include the most notable (typically songs playing during key scenes).
|-
! scope="row" | photographer
| The [[Cinematographer|director(s) of photography]] of this episode. Separate multiple people using {{Tl|Plainlist}}. In addition, link each director of photography to their appropriate article if possible.
|-
! scope="row" | editor
| The [[Film editor|editor(s)]] of this episode. Separate multiple people using {{Tl|Plainlist}}. In addition, link each editor to their appropriate article if possible.
|-
! scope="row" | production
| The [[Production code number|production code]] or number of this episode.
|-
! scope="row" | airdate
| The original airing date of the episode; use {{tl|Start date}}.
|-
! scope="row" | release_date
| The original release date of the episode. This should be used for episodes released on streaming services such as [[Netflix]]; use {{tl|Start date}}.
|-
! scope="row" | length
| The original length of the episode in minutes. It should indicate runtime (without commercials), or with commercials.
|-
! scope="row" | awards
| Awards won by the episode.
|-
! scope="row" | guests_title
| Text for display in guests header (default = Guest appearance(s)).
|-
! scope="row" | guests
| [[Guest star]](s) in the episode. Separate entries with {{Tl|Plainlist}} or bullets (<nowiki>*</nowiki>). If using bullets, include the name of the character the guest actor portrays using a single space, "as", and another single space: "<actor> as <character>". Link to the appropriate character article, if one exists.
|-
! scope="row" | module
| An optional parameter to add a nested infobox to.
|-
! scope="row" | {{Unbulleted list|prev|RPrev}}
| Wikilink to the previous episode. If an article does not exist, link to the season with an anchor to that episode. If this is the first episode of the TV series, leave blank. Title is automatically put within quotation marks; unless RPrev is used.
|-
! scope="row" | {{Unbulleted list|next|RNext}}
| Wikilink to the next episode. If an article does not exist, link to the season with an anchor to that episode. If this is the last episode of the TV series, leave blank. Title is automatically put within quotation marks, unless RNext is used.
|-
! scope="row" | season_article
| Title of the season article, usually in the form of "<showname> (season #)" article. Use plain text, the template will automatically format and link the article.
|-
! scope="row" | episode_list
| Title of the list of episodes article, usually in the form of "List of <showname> episodes" article. Use plain text, the template will automatically format and link the article.
|}

=== Controlling line-breaking in embedded bulletless lists ===
Template {{tlx|nbsp}} may be used with {{tlx|wbr}} and {{tlx|nowrap}} to control line-breaking in bulletless lists embedded in the infobox (e.g. cast and other credits lists), to prevent wrapped long entries from being confused with multiple entries. See [[Template:Wbr/doc#Controlling line-breaking in infoboxes]] for details.

===TemplateData===
{{Collapse top|title=[[Wikipedia:TemplateData|TemplateData]] documentation used by [[Wikipedia:VisualEditor|VisualEditor]] and other tools}}
{{TemplateData header|noheader=1}}
<templatedata>
{
	"description": "Infobox used on articles about television episodes or internet videos.",
	"params": {
		"child": {
			"label": "Child",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "An optional parameter make this a child infobox."
		},
		"no_italic": {
			"label": "No italic",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Any value will display the automatic italicization of the series name in the parenthesis. This parameter should not be used most of the time."
		},
		"title": {
			"label": "Title",
			"type": "string",
			"required": true,
			"suggested": false,
			"deprecated": false,
			"description": "The title of the episode. The title is automatically put within quotation marks."
		},
		"RTitle": {
			"label": "Raw title",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The title of the episode. The title is styled without quotation marks."
		},
		"series": {
			"label": "Series name",
			"type": "wiki-page-name",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The name of the TV series this episode is part of, with a link to the series' main article. Series name is automatically italicized."
		},
		"not_dab": {
			"label": "Not using disambiguation",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "A parameter that is used when the series name has parenthesis which are part of the title, such as Randall and Hopkirk (Deceased)."
		},
		"image": {
			"label": "Image",
			"type": "wiki-file-name",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "An image relevant to the episode."
		},
		"image_size": {
			"label": "Image size",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Image size in pixels. Should be 250 or less. If not specified, image defaults to frameless (220px). 'px' is not required."
		},
		"image_alt": {
			"label": "Image alt",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Alt text for image per WP:MOSALT."
		},
		"caption": {
			"label": "Image caption",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "A caption explaining the image."
		},
		"season": {
			"label": "Season number",
			"type": "number",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The number of the season this episode is part of. Use either \"season\" or \"series_no\", but not both."
		},
		"series_no": {
			"label": "Series number",
			"type": "number",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Typically, \"Series\" is used for television series produced within the United Kingdom while \"Season\" is used for American television series."
		},
		"episode": {
			"label": "Episode number",
			"type": "number",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The number of the episode within the season."
		},
		"multi_episodes": {
			"label": "Multi episodes",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "A parameter to alter select wording of the infobox when used for multi-part episodes with the same title."
		},
		"director": {
			"label": "Director",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The director(s) of this episode. Separate multiple people using {{Plainlist}}. In addition, link each director to their appropriate article if possible."
		},
		"writer": {
			"label": "Writer",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The writer(s) of this episode. Separate multiple people using {{Plainlist}}. In addition, link each writer to their appropriate article if possible."
		},
		"story": {
			"label": "Story writer",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The writer(s) of the episode's story. Separate multiple people using {{Plainlist}}. Use this field instead of the normal writer field if television episodes divide writing credits between teleplay and story writers."
		},
		"teleplay": {
			"label": "Teleplay writer",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The writer(s) of the episode's teleplay. Separate multiple people using {{Plainlist}}. Use this field instead of the normal writer field if television episodes divide writing credits between teleplay and story writers."
		},
		"based_on": {
			"label": "Based on",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The original work the episode is based on. Use {{Tl|based on}} to add the title of the source material and the name(s) of the source material writer(s). Use this field in conjunction with teleplay and story where applicable. This field should be used if the episode is based on previously produced or published material, such as books, plays, articles, old screenplays, etc. and should not be used where the source material is ambiguous. This field should not be used for general adaptations, such as ''The Flash'' (2014 TV series) episodes being based on characters from DC Comics, however, do use it if a specific episode of that series is a direct adaptation of a specific comic."
		},
		"narrator": {
			"label": "Narrator",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The narrator(s) of this episode. Separate multiple people using {{Plainlist}}. In addition, link each narrator to their appropriate article if possible."
		},
		"presenter": {
			"label": "Presenter",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Person who fronts (hosts) the episode."
		},
		"producer": {
			"label": "Producer",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The producer(s) of this episode. As television episodes typically have several credited producers, not all of whom had a direct role in the production of the episode, it is advisable to just include the show runner(s). Separate multiple people using {{Plainlist}}. In addition, link each producer to their appropriate article if possible."
		},
		"music": {
			"label": "Music",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The music of this episode. Separate multiple songs using {{Plainlist}}. Television episodes often include numerous songs; only include the most notable (typically songs playing during key scenes)."
		},
		"photographer": {
			"label": "Photographer",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The director(s) of photography of this episode. Separate multiple people using {{Plainlist}}. In addition, link each director of photography to their appropriate article if possible."
		},
		"editor": {
			"label": "Editor",
			"type": "string",
			"required": false,
			"suggested": true,
			"deprecated": false,
			"description": "The editor(s) of this episode. Separate multiple people using {{Plainlist}}. In addition, link each editor to their appropriate article if possible."
		},
		"production": {
			"label": "Production code",
			"type": "number",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The production code or number of this episode."
		},
		"airdate": {
			"label": "Airdate",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The original airing date of the episode; use {{tl|Start date}}."
		},
		"release_date": {
			"label": "Release date",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The original release date of the episode. This should be used for episodes released on streaming services such as Netflix; use {{tl|Start date}}."
		},
		"length": {
			"label": "Episode length",
			"type": "number",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The original length of the episode in minutes. It should indicate run-time (without commercials), or with commercials.",
			"aliases": [
				"runtime"
			]
		},
		"awards": {
			"label": "Awards",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Awards won by the episode."
		},
		"guests_title": {
			"label": "Guest header text",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Text for display in guests header (default = Guest appearance(s))."
		},
		"guests": {
			"label": "Guest stars",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Guest star(s) of this episode. Separate multiple people using {{Plainlist}}, or bullets (*). If using bullets, include the character the guest actor portray in the episode after their name in the infobox (using a single space, \"as\" and another single space: \"<actor> as <character>\"). Provide a link to the appropriate article if possible. Only guest actors in notable roles should be included in the list."
		},
		"module": {
			"label": "Module",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "An optional parameter to add a nested infobox to."
		},
		"prev": {
			"label": "Previous episode",
			"type": "wiki-page-name",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Wikilink to the previous episode. If an article does not exist, link to the season with an anchor to that episode, see Template:Episode list for more info. If this is the first episode of the TV series, leave blank. Title is automatically put within quotation marks."
		},
		"RPrev": {
			"label": "Raw previous episode",
			"type": "wiki-page-name",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Wikilink to the previous episode. If an article does not exist, link to the season with an anchor to that episode. If this is the last episode of the TV series, leave blank. Title is styled without quotation marks."
		},
		"next": {
			"label": "Next episode",
			"type": "wiki-page-name",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Wikilink to the next episode. If an article does not exist, link to the season with an anchor to that episode. If this is the last episode of the TV series, leave blank. Title is automatically put within quotation marks."
		},
		"RNext": {
			"label": "Raw next episode",
			"type": "wiki-page-name",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "\tWikilink to the next episode. If an article does not exist, link to the season with an anchor to that episode, see Template:Episode list for more info. If this is the last episode of the TV series, leave blank. Title is styled without quotation marks."
		},
		"season_article": {
			"label": "Season article",
			"type": "wiki-page-name",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Title of the season article, usually in the form of '<showname> (season #)' article. Use plain text, the template will automatically format and link the article."
		},
		"episode_list": {
			"label": "Episode list",
			"type": "wiki-page-name",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Title of the list of episodes article, usually in the form of 'List of <showname> episodes' article. Use plain text, the template will automatically format and link the article."
		},
		"image_upright": {
			"default": "1.13"
		}
	},
	"format": "{{_\n| _______________= _\n}}\n",
	"paramOrder": [
		"child",
		"no_italic",
		"title",
		"RTitle",
		"series",
		"not_dab",
		"image",
		"image_size",
		"image_alt",
		"image_upright",
		"caption",
		"season",
		"series_no",
		"episode",
		"multi_episodes",
		"director",
		"writer",
		"story",
		"teleplay",
		"based_on",
		"narrator",
		"presenter",
		"producer",
		"music",
		"photographer",
		"editor",
		"production",
		"airdate",
		"release_date",
		"length",
		"awards",
		"guests_title",
		"guests",
		"module",
		"prev",
		"RPrev",
		"next",
		"RNext",
		"season_article",
		"episode_list"
	]
}
</templatedata>
{{Collapse bottom}}

== Example ==
{{Infobox television episode
| title          = Subway
| series         = [[Homicide: Life on the Street]]
| image          = NYCSub 7 Vernon Jackson 3.jpg
| image_alt      = A man wearing a white shirt and blank pants kneels and speaks to a man in a blue shirt who is pinned between a subway train car and a platform. Emergency equipment lies in front of them, while the obscured figures of firefighters and emergency personnel stand behind them.
| caption        = [[Frank Pembleton]] talks to John Lange, a man pinned between a subway train and platform.
| season         = 6 
| episode        = 7
| airdate        = {{Start date|1997|12|05}}
| production     = 604
| writer         = [[James Yoshimura]]
| director       = [[Gary Fleder]]
| photographer   = [[Alex Zakrzewski]]
| guests         = 
* [[Vincent D'Onofrio]] as John Lange
* [[Shari Elliker]] as witness
* Bruce MacVittie as Larry Biedron
* Laura MacDonald as Sarah Flannigan
* Lisa Matthews as witness
* Wendee Pratt as Joy Tolson
| season_article = Homicide: Life on the Street (season 6)
| episode_list   = List of Homicide: Life on the Street episodes
| prev           = [[Homicide: Life on the Street (season 6)#ep83|Saigon Rose]]
| next           = [[Homicide: Life on the Street (season 6)#ep85|All is Bright]]
}}
<pre style="width:auto; overflow:auto">
{{Infobox television episode
| title          = Subway
| series         = [[Homicide: Life on the Street]]
| image          = NYCSub 7 Vernon Jackson 3.jpg
| image_alt      = A man wearing a white shirt and blank pants kneels and speaks to a man in a blue shirt who is pinned between a subway train car and a platform. Emergency equipment lies in front of them, while the obscured figures of firefighters and emergency personnel stand behind them.
| caption        = [[Frank Pembleton]] talks to John Lange, a man pinned between a subway train and platform.
| season         = 6 
| episode        = 7
| airdate        = {{Start date|1997|12|05}}
| production     = 604
| writer         = [[James Yoshimura]]
| director       = [[Gary Fleder]]
| photographer   = [[Alex Zakrzewski]]
| guests         = 
* [[Vincent D'Onofrio]] as John Lange
* [[Shari Elliker]] as witness
* Bruce MacVittie as Larry Biedron
* Laura MacDonald as Sarah Flannigan
* Lisa Matthews as witness
* Wendee Pratt as Joy Tolson
| season_article = Homicide: Life on the Street (season 6)
| episode_list   = List of Homicide: Life on the Street episodes
| prev           = [[Homicide: Life on the Street (season 6)#ep83|Saigon Rose]]
| next           = [[Homicide: Life on the Street (season 6)#ep85|All is Bright]]
}}
</pre>
{{clear}}

== Microformat ==
{{UF-hcal}}

== Tracking categories ==
<section begin=Tracking/>
* {{Category link with count|Pages using infobox television episode with unknown parameters}}
* {{Category link with count|Pages using infobox television episode with incorrectly formatted episode list}}
* {{Category link with count|Pages using infobox television episode with the based on parameter}}
* {{Category link with count|Television episode articles with short description with no series name}}
* {{Category link with count|Television episode articles with short description with no season number}}
* {{Category link with count|Television episode articles with short description with no episode number}}<section end=Tracking/>

== See also ==
{{Film- and television-related infobox templates}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Television episode infobox templates| ]]
[[Category:Television infobox templates|Television episode]]
[[Category:Infobox templates with module parameter|Television episode]]
[[Category:Templates that add a tracking category]]
}}</includeonly>