Template:Infobox film
 | This template is used on approximately 165,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 infobox should italicize the article title automatically. If this is not required, add |italic_title=no to the list of parameters. If this is required but the title is not being italicized, try |italic_title=force. |
| This template adds an automatically generated short description. If the automatic short description is not optimal, replace it by adding {{Short description}} at the top of the article. |
 | This template uses Lua: |
Infobox film is used to create an infobox which summarizes the main information of a particular motion picture.
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.
{{Infobox film
| name =
| image =
| alt =
| caption =
| native_name = <!-- {{Infobox name module|language|title}} or {{Infobox name module|title}} -->
| director =
| writer =
| screenplay =
| story =
| based_on = <!-- {{Based on|title of the original work|creator of the original work|additional creator(s), if necessary}} -->
| producer =
| starring =
| narrator =
| cinematography =
| editing =
| music =
| studio =
| distributor =
| released = <!-- {{Film date|YYYY|MM|DD|location|ref1=}} -->
| runtime =
| country =
| language =
| budget =
| gross =
}}
Parameters
All parameters are optional.
Calculating "image_upright"
The |image_upright= parameter, and |image2_upright= and |logo_upright= where applicable, are provided so as to facilitate the use of scalable images in this infobox, in accordance with the instructions at WP:IMAGESIZE, which advises against the use of "px" (for example: thumb|300px), as this forces a fixed image width.
Scalable images respect the user's base preference, which may have been selected for that user's particular devices. Module:InfoboxImage, which is used in this infobox, accommodates the use of scaling. However, setting the appropriate scale is slightly more complex than setting a raw "px" value. This guide provides a quick conversion table to make the process of setting a scale easier. It is based on a default thumbnail setting of 220px.
170px→upright=0.75180px→upright=0.8190px→upright=0.85200px→upright=0.9210px→upright=0.95220px→upright=1230px→upright=1.05240px→upright=1.1250px→upright=1.15260px→upright=1.2270px→upright=1.23280px→upright=1.25290px→upright=1.3300px→upright=1.35
Additional parameter usage explanation
Image
Ideally, an image of the film's original theatrical release poster should be uploaded and added to the infobox to serve as an identifying image for the article. Poster images can be found at websites such as Internet Movie Poster Awards or MoviePosterDB. If a poster image cannot be found for the film, or if the film did not have a theatrical release, then a cover image of the film's display case (VHS, DVD, etc.) may be used instead. Cover images can be found at commercial websites such as Amazon.com or Amazon.co.uk. In the absence of an appropriate poster or cover image, a screenshot of the film's title card may also be used. When replacing an existing image, upload the new image over the old image (where possible), and update the relevant details on the image description page. See Wikipedia's non-free content policy to learn about the appropriate use of copyrighted images (such as most poster images) on Wikipedia, and see introduction to uploading images to find instructions for uploading an image.
Once uploaded, place the file name of the image, e.g., FILM TITLE poster.jpg (or a similar description), in the |image= field of the infobox, but do not include the File: part of the file name. The |caption= field should describe the image, i.e., identifying it as "Theatrical release poster" (or "Promotional release poster", which may be appropriate if the film has a poster but did not receive a wide theatrical release, or its theatrical release status is unknown) or "DVD cover"; repeating the title of the film here is not necessary. Below is an example of how to use the fields:
| name = FILM TITLE
| image = FILM TITLE poster.jpg
| caption = Theatrical release poster
Nationalities (e.g. "American theatrical release poster", "French release poster", "Japanese release poster", etc.) should be excluded from the caption, unless the poster in question is not from the film's country of origin. If the poster used is not from the film's country of origin, then the poster's language or country of origin can be specified (see the English-language poster in the infobox for Uncle Boonmee Who Can Recall His Past Lives as an example).
If the poster is illustrated, its illustrator may be specified in the caption (see the infobox caption for E.T. the Extra-Terrestrial, which reads "Theatrical release poster by John Alvin"). Inclusions of artist names in film infobox captions should be reliably sourced.
Credits
Credits in the infobox should not be retrospectively altered to accommodate name changes at a later date. A person should be credited by the name they were using professionally at the time the film was made.
Distributor
Using the same rationale as the release date, the distributor(s) should be restricted to the country or countries that produced the film and (if different) the country where the film is first released. If there are only two distributors in total (a domestic and foreign) then include both of them.
Release dates
The film infobox is too small to reproduce the long lists of release dates such as those seen at various databases (e.g. IMDb). Release dates should therefore be restricted to the film's earliest release, whether it was at a film festival, a world premiere, or a public release, and the release date(s) in the country or countries that produced the film, excluding sneak previews or screenings. Dates should be reliably sourced. If the film was officially distributed by a streaming service such as Netflix for its original release (not including cases where the service has only acquired distribution rights for certain overseas regions that don't include the producing countries), then the date it was released on the platform should also be included. If other release dates are found to be notable, it may be appropriate to include them in the main body of the article (example).
{{Film date}} should be used for the film's release dates, which automatically adds the film to the appropriate release year category (such as 2025 films), and Upcoming films when appropriate. Please see that template's documentation for more info.
Release dates for straight-to-video and television films should follow the preceding guideline for home releases and airings, respectively.
Using flag icons instead of country names should be avoided, as flags are less recognizable than country names. See Wikipedia:Manual of Style (flags) for a more detailed rationale.
Runtime
The runtime for the film should be for the primary release; this will usually be the format the film premiered on, so for films that have had a theatrical release insert the runtime of the original theatrical version. Runtimes can vary due to regional censorship, alternative cuts (such as a director's cut or an unrated version) and different technical specifications across release formats, but do not include any additional runtimes without consensus. Use a reliable secondary source, such as the BBFC classification site, to cite the information; do not time it yourself, and for upcoming releases, do not take it from theater chain or ticketing service websites. If using the BBFC website as a source take note that a film may have been submitted to the BBFC several times for classification and have several different runtimes associated with it depending on format, version and component (such as a DVD commentary), so be careful to source the correct time, which are all listed at the entry page for the film under "Cinema".
Home video packaging should only be used to source runtimes for direct-to-video films or for films that may not have been classified; reliable secondary sources are still preferable in these instances if at all possible.
Country
According to the European Lumiere project, the value of this parameter is seldom found in the primary source (the film) and often involves original research:
- "defining the nationality of a film is a complex task. There are no widely accepted international or even European definitions of the criteria to be used to determine the country of origin of a film. This is both a legal and a statistical problem. It is enlightening to compare the lists provided by the different national sources that we use: countries involved in a joint production are not always indicated (even when the main coproducer is from another country). Different national records – and the statistics on which they are based – can show the same film as having a whole range of nationalities." (from "Identification of the producing countries in LUMIERE". European Audiovisual Observatory. 2006.)
If multiple countries are listed, the {{ubl}} or {{plainlist}} templates should be used to avoid generating Wikipedia page with obscure country errors.
Controlling line-breaking in embedded bulletless lists
Template {{nbsp}} may be used with {{wbr}} and {{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
TemplateData documentation used by VisualEditor and other tools |
|---|
See a monthly parameter usage report for Template:Infobox film in articles based on its TemplateData. TemplateData for Infobox film {{Infobox film}} is used to list at-a-glance comparative information about a particular motion picture. |
Examples
{{Infobox film
| name = Plan 9 from Outer Space
| image = Plan nine from outer space.jpg
| alt = Poster reading "Plan 9 From Outer Space".
| caption = Theatrical release poster
| director = [[Edward D. Wood Jr.]]
| writer = Edward D. Wood Jr.
| producer = J. Edward Reynolds
| starring = {{Plainlist|
* [[Béla Lugosi]]
* [[Maila Nurmi|Vampira]]
* [[Lyle Talbot]]
}}
| cinematography = [[William C. Thompson (cinematographer)|William C. Thompson]]
| editing = Edward D. Wood Jr.
| distributor = Distributors Corporation of America
| released = {{Film date|1959|07}}
| runtime = 79 minutes
| country = United States
| language = English
| budget = $60,000
}}
Removed parameters
IMDb, AllMovie and other external links
When this infobox template was first created in December 2004, one of the parameters created an external link to IMDb. Irrespective of the fact that IMDb is not used as a reliable source for verifying content in Wikipedia articles, it still is a resource that many people, including editors and readers of Wikipedia, often turn to.
In more recent years, additional external websites have become increasingly useful resources, including AllMovie, Box Office Mojo, the British Film Institute, Metacritic, and Rotten Tomatoes. Also, modern films almost invariably have an official website. As a consequence, new external links were added to and removed from the infobox as consensus changed on the subject.
Discussions about the fate of these links took place in numerous places over some time, with a number of people advocating removal of all external links from the infobox, if not the article as a whole. Others spoke of the value of having at least a link to IMDb in the infobox. Eventually, a far from undisputed consensus arose to remove all external links from the infobox and to move them to the External links section where appropriate in view of the External links guideline.
Important points towards this consensus included fact that the infobox could not include all of the available links and that it would be inappropriate to pick and choose one or a few of those links over others. Suggestions that losing access to the most useful of the available links (typically IMDb) would damage the usefulness of film articles were not found persuasive by many since such links could still be included in the External links section and the table of contents linking to the external links section having all of the useful external links is adjacent the infobox.
External links to resources such as the Internet Movie Database (IMDb), AllMovie and any official website are no longer included in this template. Nevertheless, these resources and others may be usefully added to the "External links" section of the article using the following templates:
{{Mojo title|id=bom_id|title=film title}}{{IMDb title|id=imdb_id|title=film title}}{{Metacritic film|id=mc_id|title=film title}}{{Rotten Tomatoes|id=rt_id|title=film title}}{{TCMDb title|id=tc_id|title=film title}}
A link to the official website, if any, may be created manually, or using the {{official website|url|name=title (optional)}} template.
Ratings
Like links to IMDb, statements of a film's rating(s) have been excluded from the infobox as consensus has shifted over the years. Mainly, there are simply too many ratings systems in English-speaking countries, let alone the world over. Further, these ratings systems rarely exactly agree, and a film's rating can change drastically over time as different editions of a film are released, and re-released, to theaters, broadcast, cable, satellite, streaming, and home media. Ratings information should be integrated into the film's article.
Preceded by and Followed by
The "Preceded by" and "Followed by" parameters were removed on 16 February 2011. (See Template talk:Infobox film/Archive 19#Preceded By/Followed By.)
Microformat
- Classes used
The HTML classes of this microformat include:
- attendee
- contact
- description
- dtend
- dtstart
- location
- organiser
- summary
- url
- vevent
nor collapse nested elements which use them.
Categories added by template
- Category:English-language films and similar subcategories of Category:Films by language)
- Category:Silent films
Tracking categories (hidden)
- Category:Pages using infobox film with flag icon (0)
- Category:Pages using infobox film with missing date (2,191)
- Category:Pages using infobox film with multiple film date templates (90)
- Category:Pages using infobox film with nonstandard dates (243)
- Category:Pages using infobox film with unknown parameters (0)