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 198,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.

Usage

Unnamed parameters:

{{IMDb title|ID}}
{{IMDb title|ID|TITLE}}
{{IMDb title|ID|TITLE|DESCRIPTION}}

Named parameters:

{{IMDb title|id= ID}}
{{IMDb title|id= ID|title= TITLE}}
{{IMDb title|id= ID|title= TITLE|description= DESCRIPTION}}
{{IMDb title|id= ID|quotes= yes}}

Using Wikidata property IMDb ID (P345):

{{IMDb title}}
{{IMDb title|title= TITLE}}
{{IMDb title|title= TITLE|description= DESCRIPTION}}
{{IMDb title|quotes= yes}}

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. The description is rendered outside the automatic quote marks or italic formatting.

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/doc at IMDb
- {{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}} → Alpha Dog at IMDb
{{IMDb title|id=0426883|title=Alpha Dog}} → Alpha Dog at IMDb

Parameter: description (3)

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

Parameter: qid

Using Wikidata property IMDb ID (P345) from Wikidata item Stargate (Q105801):

{{IMDb title|qid=Q105801|title=Stargate}} → Stargate at IMDb

No parameters

Usage in Wikipedia article Stargate (film):

{{IMDb title}} → Stargate at IMDb

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:IMDb title in articles based on its 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
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}}.

Sections

The template will automatically change when the template is used on lists of awards, characters, or soundtracks. The url is made more specific to reflect the articles scope. This is done by identifying the articles type through Wikidata.

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: