Template:IMDb episodes/sandbox

This is the template sandbox page for Template:IMDb episodes (diff).
See also the companion subpage for test cases.

Template documentation[view] [edit] [history] [purge]

This template is used on approximately 3,200 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Preview message: Transclusion count updated automatically (see documentation).

Template:IMDb episodes generates links to an IMDb TV series or web series episode list. Because this is most useful in articles for individual seasons of series and list-of-episodes articles for entire series, the template is designed to be easy to use on pages like:

In these cases, the template needs only the IMDb ID number of the series (see below); the title and (when applicable) season number need not be specified. However, the template will be confused by titles like:

Big Brother 3 (American season)

In such a case, you will need to override the template's autodetection of the season number (in this case, by using |season=3) and possibly the series title, as well.

Finding the IMDb ID

Search on imdb.com for the title you want. On the Wikipedia page for the TV series, this can often be done conveniently with the link produced by previewing the template call {{IMDb title}}. This may not work if the page title is more than just the TV show title. (See the examples below for more details.)
Click on the correct link (at imdb.com) to go to the page for the TV series (or whatever you're looking for). Be sure you're using the correct title page.
The page URL should look like https://www.imdb.com/title/tt#######, where "#######" indicates a number.
Copy only that number^[a] (omit the "tt" part), and use it in the template call, as shown below.

Usage

{{IMDb episodes|id}}
{{IMDb episodes|id|title|description|season=}}

Parameters

Parameter	Explanation
`1` `id`	Required. The ID number of the IMDb title, taken from the numbers at the end of its IMDb URL.
`2` `title`	Optional. The title of the TV series. Defaults to the Wikipedia article name ({{PAGENAMEBASE}}), without any disambiguation such as (season 1) or without the "List of episodes" text.
`3` `description`	Optional. An optional description.
`season`	Optional. The season number. If not specified, defaults to the season number in the article title disambiguation text.
`year`	Optional. The number of the year for pages like separate seasons by years (such as MythBusters (2006 season)).

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:IMDb episodes in articles based on its TemplateData.

TemplateData for IMDb episodes

An external link template that links to an IMDb television series episode list page.

Template parameters[Edit template data]
Parameter		Description	Type	Status
ID	`1` `id`	The ID number of the IMDb title, taken from the numbers at the end of its IMDb URL.	Number	required
Title	`2` `episode`	The title of the TV series. Defaults to the Wikipedia article name, without any disambiguation such as (season 1) or without the "List of episodes" text.	Line	optional
Description	`3` `description`	An optional description.	Line	optional
Season	`season`	The season number. If not specified, defaults to the season number in the article title disambiguation text.	Number	optional
Year	`year`	The number of the year for pages like separate seasons by years.	Number	optional

Example

If you wanted to add this template to an article like Cavalcade of America (note: it's already there, in the "External links" section):

Edit the article/section and add the template call {{IMDb title}} at the appropriate place, previewing the result (don't publish your changes yet—only preview them).
The resulting link may look like Cavalcade of America (where the URL ends in a number) or Cavalcade of America (where the URL contains the title). In the first case, the template already "knows" the IMDb ID number for the film (because the page has a Wikidata item containing that information), so you can just copy the URL and extract the number at the end (0044248). In the second case, you'll have to follow the link to the search results at the IMDb and find the appropriate page there. In either case, you'll find this URL: https://www.imdb.com/title/tt0044248/
Copy the number at the end of the URL (0044248), then replace the {{IMDb title}} template call with a call to {{IMDB episodes}}, including the number as a parameter: {{IMDb episodes|0044248}}
Preview your changes again, making sure the link actually works and looks the way you want. If it does, save/publish your changes. The result on the page Cavalcade of America is: Cavalcade of America at IMDb

Second example

To add this template to the Route 66 (1993 TV series) article:

Search the IMDb for the appropriate TV series. You will find this page: https://www.imdb.com/title/tt0106117/
Copy the number, "0106117", then use the following template call in the article: {{IMDb episodes|0106117|Route 66|(1993)}}
The result is: Route 66 (1993) at IMDb

Tracking categories

Category:Pages using IMDb episodes with unknown parameters (1)

Notes

^ The leading zeros are not needed but recommended, for Linksearch uniformity is useful.

The above documentation is transcluded from Template:IMDb episodes/doc.
Editors can experiment in this template's sandbox and testcases pages.
Add categories to the /doc subpage. Subpages of this template.

[1] The leading zeros are not needed but recommended, for Linksearch uniformity is useful.

[a]