Template:Infobox movie/doc
This is a documentation subpage for Template:Infobox movie. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on many 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. |
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 uses Lua: |
Infobox movie is used to create an infobox which summarizes the main information of a particular motion picture.
Usage
change{{{name}}} | |
---|---|
[[File:{{{image}}}|{{{image_size}}} |alt={{{alt}}}|upright=1|{{{alt}}}]] | |
{{{native_name}}} | |
Directed by | {{{director}}} or {{{directors}}} |
Written by | {{{writer}}} or {{{writers}}} |
Screenplay by | {{{screenplay}}} |
Story by | {{{story}}} |
Based on | {{{based_on}}} |
Produced by | {{{producer}}} or {{{producers}}} |
Starring | {{{starring}}} |
Narrated by | {{{narrator}}} or {{{narrators}}} |
Cinematography | {{{cinematography}}} |
Edited by | {{{editing}}} |
Music by | {{{music}}} |
Production companies | {{{studio}}} or {{{production_companies}}} |
Distributed by | {{{distributor}}} |
Release date | {{{released}}} |
Running time | {{{runtime}}} |
Country | {{{country}}} |
Language | {{{language}}} |
Budget | {{{budget}}} |
Box office | {{{gross}}} |
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 movie
| name =
| image =
| alt =
| caption =
| native_name = <!-- {{Infobox name module|language|title}} or {{Infobox name module|title}} -->
| director =
| producer =
| writer =
| screenplay =
| story =
| based_on = <!-- {{Based on|title of the original work|creator of the original work|additional creator(s), if necessary}} -->
| starring =
| narrator =
| music =
| cinematography =
| editing =
| studio = <!-- or: | production_companies = -->
| distributor = <!-- or: | distributors = -->
| released = <!-- {{Film date|df=yes/no|year|month|day|location|ref1=}} -->
| runtime =
| country =
| language =
| budget =
| gross =
}}
Parameters
changeAll parameters are optional.
Parameter | Explanation |
---|---|
italic_title
|
Set to no if the title of the article should not be automatically italicised (for instance, if the title has a disambiguation clause).
|
name
|
Insert the full common name of the movie (defaults to {{PAGENAMEBASE}} if empty).
|
image
|
Insert a relevant image for the movie. Ideally this should be a movie poster, but a DVD/VHS cover, screenshot, or other movie-related image may also be used. Only use the actual file name, i.e. |image=Forrest Gump poster.jpg . See #Image for further guidelines.
|
alt
|
Alt text for the image. See WP:ALT. This field is normally not visible in standard web browsers, but you can see it by requesting the image's properties from the browser. A visually impaired reader will typically hear the alt text in place of the image. |
caption
|
Insert image caption, which should describe the type of image used. |
native_name
|
Insert the native title of the movie using the {{Infobox name module}} template if it is different from the displayed title; please visit that template's page for full instructions. This parameter is for the native title only, i.e. it should not be used to add translated titles to the infobox. |
director
|
Insert the name(s) of the director(s). Separate multiple entries using either {{ubl}} or {{plainlist}}. Link each director to their article if possible. |
producer
|
Insert the name(s) of the producer(s). Separate multiple entries using either {{ubl}} or {{plainlist}}. Link each producer to their article if possible. Only producer credits should be included, not executive producers, associate producers, etc. |
writer
|
Insert the name(s) of the writer(s). This field is primarily used for movies where the writer(s) are credited under "Written by". Separate multiple entries using either {{ubl}} or {{plainlist}}. Link each writer to their article if possible. |
screenplay
|
Insert the name(s) of the screenplay writer(s). Separate multiple entries using either {{ubl}} or {{plainlist}}. Use this field instead of the normal writer field if movies divide writing credits between screenplay and story writers. Link each writer to their article if possible. |
story
|
Insert the name(s) of the story writer(s). Separate multiple entries using either {{ubl}} or {{plainlist}}. Use this field instead of the normal writer field if movies divide writing credits between screenplay and story writers. Link each writer to their article if possible. |
based_on
|
Insert the title of the source material and the name(s) of the source material writer(s). Use this field in conjunction with screenplay and story where applicable (i.e. "Screen story") if movies are based on previously produced or published material, such as books, plays, articles, old screenplays etc. Use {{based on}} or similar formatting where possible. Do not use this field where the source material is ambiguous. |
starring
|
Insert the names of the actors as they are listed in the billing block of the poster for the movie's original theatrical release.[1] If unavailable, use the top-billed actors from the screen credits. Other additions by consensus. Use either the {{ubl}} or {{plainlist}} template for multiple entries, and link each actor to their article if possible. Don't add additional text (such as "with" or "featuring") or punctuation to the list. |
narrator
|
Insert the name(s) of the narrator(s). Separate multiple entries using either {{ubl}} or {{plainlist}}. Link each narrator to their article if possible. Note: This field is only to be used for the narrator of documentaries. |
music
|
Insert the name(s) of the composer(s) of the original music score. They are usually credited with "Music by". Composers credited for "additional music" and songwriters should not be included. Separate multiple entries using either {{ubl}} or {{plainlist}}. Link each composer to their article if possible. |
cinematography
|
Insert the name(s) of the cinematographer(s) or director(s) of photography. Separate multiple entries using either {{ubl}} or {{plainlist}}. Link each cinematographer or director of photography to their article if possible. |
editing
|
Insert the name(s) of the editor(s). Separate multiple entries using either {{ubl}} or {{plainlist}}. Listing "additional editors" and "supervising editors" may occasionally be appropriate, in which case add the tag "(add)" or "(sup)". Link each editor to their article if possible. |
animator
|
Insert the name(s) of the animator(s). Separate multiple entries using either {{ubl}} or {{plainlist}}. Link each animator to their article if possible. |
layout_artist
|
Insert the name(s) of the layout artist(s). Separate multiple entries using either {{ubl}} or {{plainlist}}. Link each layout artist to their article if possible. |
background_artist
|
Insert the name(s) of the background artist(s). Separate multiple entries using either {{ubl}} or {{plainlist}}. Link each background artist to their article if possible. |
color_process
|
For animated movies only. Insert the type of film stock used to make the movie. For most cartoons, this should be filled only with one of the following choices: black and white, Sepia tone, Technicolor, Technicolor (two-color), Cinecolor, Polacolor, or Metrocolor. For more modern (post-1970) cartoons, "Color" will suffice. |
|
Insert the company or companies that produced the movie. Separate multiple entries using either {{ubl}} or {{plainlist}}, and use the "production_companies" parameter. Link each company to its article if possible. When possible, this should be cited to reliable secondary sources that explicitly identify the production companies. |
distributor
|
Insert the company name(s) of the distributor(s) that first released the movie. Separate multiple entries using either {{ubl}} or {{plainlist}}. Link each distributor to its article if possible. See #Distributor for additional guidelines. |
released
|
Insert only the most relevant release date(s) of the movie. If multiple entries are required, separate using either {{ubl}} or {{plainlist}}. Use {{movie date}} . See #Release dates for additional guidelines.
|
runtime
|
Insert an approximate time duration of the movie in minutes. If the running time is given to the second, round it to the minute (and do not link to "minute"). Restrict the entry to the runtime for the primary release. See #Runtime for additional guidelines. |
country
|
|
language
|
Insert the language primarily used in the movie. Databases often give every language spoken within the movie, even if they only reflect a few lines in the overall script. The BBFC website is a good resource for the main language used in the fmovie. Only in rare cases of clearly bilingual or multilingual movies, enter separate entries with {{unbulleted list}}. In the case of a single language without any additional text, the movie article will be put automatically in the category concerned.
Note: languages are not automatically linked. This has been done intentionally because according to WP:OVERLINK, most major languages should generally not be linked. Please do not override this by using a piped link such as [[English language|English]]. |
budget
|
Insert the approximate production budget of the movie. This is the cost of the actual filming, and does not include marketing/promotional costs (e.g. advertisements, commercials, posters). Budget figures can be found at Box Office Mojo, The Numbers, the Los Angeles Times, Variety, etc. If there are conflicting estimates, do not cherry-pick; list each estimate either as an individual value or as a number range. Do not use primary sources to corroborate budget figures. When applicable, add "gross" and "net" parenthetically beside the figure(s), using the either {{ubl}} or {{plainlist}} template. |
gross
|
Insert the worldwide gross revenue accrued by the movie in its theatrical run (home media sales should instead be covered in the article body). This information is available for many Hollywood pictures at Box Office Mojo and The Numbers. If worldwide gross is not available, then indicate which region has grossed that amount. Use condensed, rounded values ($22.4 million vs $22,392,684). Precise values should be used where stable and appropriate to the context, or significant in themselves for some special reason. (See also: MOS:LARGENUM and this consensus discussion.) |
Additional parameter usage explanation
changeImage
changeIdeally, an image of the movie'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 Internet Movie Poster Database. If a poster image cannot be found for the movie, or if the movie did not have a theatrical release, then a cover image of the movie'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 movie'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., movie title poster.jpg (or a similar description), in the image=
field of the infobox, but do not include the Image:
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 movie 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 movie here is not necessary. Below is an example of how to use the fields:
| name = MOVIE TITLE | image = MOVIE 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 movie's country of origin. If the poster used is not from the movie'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 movie infobox captions should be reliably sourced.
Credits
changeCredits 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 movie was made.
Distributor
changeUsing the same rationale as the release date, the distributor(s) should be restricted to the country or countries that produced the movie and (if different) the country where the movieis first released. If there are only two distributors in total (a domestic and foreign) then include both of them.
Release dates
changeThe movie infobox is too small to reproduce the long lists of release dates provided by sources such as the Internet Movie Database. Release dates should therefore be restricted to the movie'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 movie, excluding sneak previews or screenings. 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 movie's release dates, which automatically adds the movie to the appropriate release year category (such as 2024 movies), and Upcoming movies when appropriate. Please see that template's documentation for more info.
Release dates for straight-to-video and television movies should follow the preceding guideline for home releases and airings, respectively.
Some editors like to use flag icons instead of country names. This should be avoided, as flags are less recognizable than country names. See Wikipedia:Manual of Style (flags) for a more detailed rationale.
Runtime
changeThe runtime for the movie should be for the primary release; this will usually be the format the movie premiered on, so for movies 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 websites. If using the BBFC website as a source take note that a movie 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 bottom of the entry page for the movie under "Feature".
Home video packaging should only be used to source runtimes for direct-to-video movies or for movies that may not have been classified; reliable secondary sources are still preferable in these instances if at all possible.
Country
changeAccording to the European Lumiere project, the value of this parameter is seldom found in the primary source (the movie) and often involves original research:
- "defining the nationality of a movie 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 movie. 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 movie as having a whole range of nationalities." (from "Identification of Films in the Lumiere Database". European Audiovisual Observatory. 2006.)
Controlling line-breaking in embedded bulletless lists
changeTemplate {{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
changeTemplateData documentation used by VisualEditor and other tools
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
See a monthly parameter usage report for Template:Infobox movie in articles based on its TemplateData.
TemplateData for Infobox movie {{Infobox movie}} is used to list at-a-glance comparative information about a particular motion picture.
|
Examples
changePlan 9 from Outer Space | |
---|---|
Directed by | Edward D. Wood Jr. |
Written by | Edward D. Wood Jr. |
Produced by | J. Edward Reynolds |
Starring | |
Narrated by | The Amazing Criswell |
Cinematography | William C. Thompson |
Edited by | Edward D. Wood Jr. |
Music by | Gordon Zahler |
Distributed by | Distributors Corporation of America |
Release date |
|
Running time | 79 minutes |
Country | United States |
Language | English |
Budget | $60,000 |
{{Infobox movie
| 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.]]
| producer = J. Edward Reynolds
| writer = Edward D. Wood Jr.
| starring = {{Plainlist|
* [[Béla Lugosi]]
* [[Maila Nurmi|Vampira]]
* [[Lyle Talbot]]
}}
| narrator = [[The Amazing Criswell]]
| music = Gordon Zahler <!--(music supervisor)-->
| 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
changeIMDb, AllMovie and links to other websites
changeWhen this infobox template was first created in December 2004, one of the parameters created a link to another website to the Internet Movie Database (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 websites to other websites have become increasingly useful resources, including AllMovie, Box Office Mojo, the British Film Institute, Metacritic, and Rotten Tomatoes. Also, modern movie almost invariably have an official website. As a consequence, new links to other websites 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 links to other websites 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 links to other websites from the infobox and to move them to the Other websites section where appropriate in view of the Other websites 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 movie articles were not found persuasive by many since such links could still be included in the Other websites section and the table of contents linking to the other websites section having all of the useful links to other websites is adjacent the infobox.
Links to other websites 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 "Other websites" section of the article using the following templates:
{{AllMovie title|id=am_id|title=movietitle}}
{{BFI|id=bfi_id|title=movie title}}
- {{tlx|Mojo title|id=bom_id|title{{=}movie title}}
{{IMDb title|id=imdb_id|title=movie title}}
{{Metacritic film|id=mc_id|title=movie title}}
{{Rotten Tomatoes|id=rt_id|title=movie title}}
{{Tcmdb title|id=tc_id|title=movie title}}
A link to the official website, if any, may be created manually, or using the {{official website|url|name=title (optional)}}
template.
Ratings
changeLike links to IMDb, statements of a movie'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 movie's rating can change drastically over time as different editions of a movie are released, and re-released, to theaters, broadcast, cable/satellite/streaming, and home media. Ratings information should be integrated into the movie's article.
Preceded by / Followed by
changeThe "Preceded by" and "Followed by" parameters were removed on 16 February 2011. (See Template talk:Infobox movie/Archive 19#Preceded By.2FFollowed By.)
Microformat
changeThe HTML mark-up produced by this template includes an hCalendar microformat that makes event details readily parsable by computer programs. This aids tasks such as the cataloguing of articles and maintenance of databases. For more information about the use of microformats on Wikipedia, please visit the Microformat WikiProject on English Wikipedia.
- 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
change- Category:English-language movies and similar subcategories of Category:movies by language)
- Category:Silent films
Tracking categories (hidden)
change- Category:Pages using infobox movie with unknown parameters (1)
- Category:Pages using infobox movie with unknown empty parameters (0)
- Category:movie articles using image size parameter (0)
Notes
changeSee also
change