Template:IMDb title/doc

This is a documentation subpage for Template:IMDb title.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 190,000 pages.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

This template uses Lua:

This template is used to generate an external link to a web page at IMDb. It should be used exclusively for TITLES—movies, TV series, games, etc.—and is intended for use in the external links section of an article.

For a person (actor, actress, etc.), use {{IMDb name}}.
For a specific TV episode or Web series episode, use {{IMDb episode}}.
For an episode list, use {{IMDb episodes}}.

Usage

Unnamed parameters:

{{IMDb title | ID}}
{{IMDb title | ID| TITLE}}
{{IMDb title | ID| TITLE| DESCRIPTION}}
{{IMDb title | ID| TITLE| DESCRIPTION| section= SECTION}}
{{IMDb title | ID| TITLE| DESCRIPTION| section= SECTION| qid= QID}}

Named parameters:

{{IMDb title | id= ID}}
{{IMDb title | id= ID| title= TITLE}}
{{IMDb title | id= ID| title= TITLE| description= DESCRIPTION}}
{{IMDb title | id= ID| title= TITLE| description= DESCRIPTION| section= SECTION}}
{{IMDb title | id= ID| title= TITLE| description= DESCRIPTION| section= SECTION| qid= QID}}
{{IMDb title | id= ID| quotes= yes}} – for short films

Using Wikidata property (P345):

{{IMDb title }}
{{IMDb title | title= TITLE}}
{{IMDb title | title= TITLE| description= DESCRIPTION}}
{{IMDb title | title= TITLE| description= DESCRIPTION| section= SECTION}}
{{IMDb title | title= TITLE| description= DESCRIPTION| section= SECTION| qid= QID}}
{{IMDb title | quotes= yes}} – for short films

Instructions

Search on IMDb.com for the title you want. On the Wikipedia page of the film concerned this can often be done with the link produced by previewing {{IMDb title}} (this may not work if the page title is more than just the film title).
Click on the correct link to go to the movie's page (or whatever you're looking for). Be sure you're getting on the correct title page.
The page URL should look like this:
https://www.imdb.com/title/tt######/

where ###### indicates a number.
Copy the 7- or 8-digit ID number that appears after tt in the URL. The leading "tt" is not required, but the template will still work if it is included. The leading zeros in the number are recommended for Linksearch uniformity.
Add the following to the external links section of the article:
{{IMDb title|######|Film Name}} or {{IMDb title|id=######|title=Film Name}}

where ###### is the number you've copied, and Film Name is the title of the movie or show.
(Optional) If you want to add an additional description to distinguish this film/show from another that may be on the same page with the same name, use the following text:
{{IMDb title|#######|Title|Description}}

where ####### is the number you've copied, Title is the title of the movie or show, and Description is the description of the show, in parentheses.
(Optional) There is also the |section= parameter which can be set to |section=awards or |section=cast to link to the Awards or Cast and Crew sections of the site.
If the IMDb page is about a short film, add |quotes=yes to display with quotation marks (per rather than the template's default italics; any value for this parameter will work, e.g. |quotes=y or |quotes=true. Note: For an episode of a TV series, use {{IMDb episode}} instead of this template.

Examples

Parameter: id (1)

Search on IMDb.com for the title Alpha Dog. This can also be done on the Wikipedia page by previewing {{IMDb title}} and clicking that link (https://www.imdb.com/find?q=Alpha+Dog&s=tt).
On the IMDb search results page, click the link for "Alpha Dog (2006)". That IMDb page URL is:
https://www.imdb.com/title/tt0426883/ or http://www.imdb.com/title/tt0426883/
Copy 0426883 and add it to the template:
- {{IMDb title|0426883}}
- {{IMDb title|id=0426883}}

Typically this is a list item in the external links section (even if there is only one link), so you should add "*" in front.

Parameter: title (2)

{{IMDb title|0426883|Alpha Dog}}
{{IMDb title|id=0426883|title=Alpha Dog}}

Parameter: description (3)

{{IMDb title|0106117|Route 66|(1993 TV series)}}
{{IMDb title|id=0106117|title=Route 66|description=(1993 TV series)}}

Parameter: section

{{IMDb title|0111282|Stargate}}
{{IMDb title|id=0111282|title=Stargate|description=(1994 film)|section=awards}}
{{IMDb title|0111282|Stargate|section=cast}}

Parameter: qid

{{IMDb title|qid=Q105801|title=Stargate}}
{{IMDb title|qid=Q105801|title=Stargate|description=(1994 film)|section=awards}}

Parameter: quotes

Used for short films, which take quotation marks instead of the default italics.

{{IMDb title|id=42360|title=Cue Ball Cat|quotes=y}}

TemplateData

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

TemplateData for IMDb title

This is a template to generate links to Internet Movie Database.

Template parameters
Parameter		Description	Type	Status
ID	`id` `1`	Number of the IMDb title, taken from the numbers at the end of its IMDb URL. This parameter is optional if Wikidata property P345 contains an ID starting with tt or the qid paramter is used, but required if not. Default Wikidata property P345 or IMDb search URL	Number	optional
Title	`title` `2`	Title of the production. Defaults to the Wikipedia article name, without any disambiguation such as (film). Default {{PAGENAMEBASE}}	String	optional
Description	`description` `3`	Description of the production, such as the year made (in parentheses).	String	optional
Section	`section`	Can be 'award' or 'awards' which makes a link to the awards page, or 'cast' to link to the cast and crew page. Other values are ignored.	String	optional
qid	`qid`	Retrieves the id stored at a specific WikiData item, this can be used to get an id stored in another item without using the 'id' parameter.	Unknown	optional
link_hide	`link_hide`	If parameter is used and has something other than blank, IMDb will not be wikilinked	Unknown	optional

Wikidata

The Wikidata project provides a central collection of information and parameters for articles for the various Wikimedia Foundation projects. This includes the IMDB title codes for films. For example, the film Space Milkshake has a corresponding Wikidata item (Q7572422), which in turn includes an IMDb identifier. If {{IMDb title}} is invoked in an article without the "id" parameter, and if Wikidata has an IMDb identifier specified for that article's corresponding item, the IMDb link with its title code will be included automatically.

For new film articles, the IMDb identifier property (and the film title item itself) may need to be added at Wikidata first, so that the default IMDb link can be available for use on Wikipedia and other Wikimedia projects.

This Wikidata capability was implemented on the English Wikipedia as of April 2013.

Note that the title code (first parameter) can still be specified as before and this will override the Wikidata default e.g. where this template is used to link to a film whose title does not correspond to the subject of the article (for example, in the case of a single article about a film and its sequels).

The second parameter for the film title override is still available to handle differences between article titles and film titles (e.g. due to disambiguation wording in the title). The first parameter may be left blank to default from Wikidata – for example {{IMDb title||Film title}}.

Linksearch

For a given link target (or first part of that) the pages from where there are links are found by a link such as this: