View source for Template:Infobox album/doc

{{documentation subpage}}
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Check for unknown parameters}}
{{Infobox album 
| italic_title = no 
 |name         = {{yesitalic|Pinkerton}}
| type         = Studio
| artist       = Weezer
| cover        = Weezer_Pinkerton.jpg
| released     = September 24, 1996
| format       = CD, cassette, vinyl
| recorded     = September 1995, January–June 1996
| studio       =
*Sound City, Los Angeles
*Fort Apache Studios, Boston
*Hollywood Sound Recorders, Los Angeles
*Rumbo Recorders, Canoga Park
*Electric Lady Studios, New York
Mixed at Ocean Way Recording
| genre        = Alternative
| length       = 34:36
| label        = DGC
| producer     = Weezer
| reviews      = 
*Allmusic {{rating|5|5}} [http://www.allmusic.com/cg/amg.dll?p=amg&sql=10:sad1vwvya9xk~T1 link]
*Artistdirect {{rating|5|5}} [http://www.artistdirect.com/nad/store/artist/album/0,,235456,00.html link]
*''Rolling Stone'' {{rating|5|3}} [http://www.rollingstone.com/artists/weezer/albums/album/301487/review/5945269/pinkerton 1996]
*''Rolling Stone'' {{rating|5|5}} [http://www.rollingstone.com/artists/weezer/albums/album/301487/review/6635729/pinkerton 2004]
*Tiny Mix Tapes {{rating|5|5}} [http://www.tinymixtapes.com/Weezer,631 link]
*Pitchfork Media 7.5/10 [http://www.pitchforkmedia.com/article/record_review/23115/Weezer_Pinkerton 1996]
| prev_title   = [[Weezer (The Blue Album)]]
| prev_year    = 1994
| next_title   = [[Weezer (The Green Album)]]
| next_year    = 2001
}}
The standard infobox for album articles is the '''{{tl|Infobox Album}}''' template. The box to the right is an example. 

The infobox code should be placed at the top of the article.
==Code==
Most articles should only need the following fields (for the full list of fields see [[#Advanced usage|advanced usage]]). Do not remove fields from this list when the value is unknown; in that case the values should be left blank. Please note that the field names are case-sensitive.

If this template is substituted, it will return a cleaned-up copy of itself with unnecessary parameters removed and deprecated parameters replaced. Parameter indentation will also automatically be fixed. 

<syntaxhighlight lang="wikitext" style="overflow:auto">
{{Infobox album 
| name        = 
| type        = 
| artist      = 
| cover       = 
| released    = 
| format      = 
| recorded    =
| studio      =
| genre       = 
| length      = 
| label       = 
| producer    = 
| reviews     = 
| prev_title  =
| prev_year   =
| next_title  =
| next_year   =
}}
</syntaxhighlight>
==Details==
Try to fill in as many of the details as you can. If some details are unknown, leave the section blank. Wikilink wherever appropriate, but make sure you check your links.

===name===
The album's title should be specified using text (not a logo), which will be automatically italicized (in the infobox and the page name.)

==={{Anchors|Colors|Type and color}} type===
The {{para|type}} field refers to the general type of album. Enter a code from the following chart. The type will appear with the appropriate color.

{{Infobox Album/doc/type}}

==={{Anchor|Album cover}} cover===
An image of the official front cover of the original version of the album (or a reissue, if no original cover can be found) should be included at '''cover'''. However, unless the album cover is represented by a free image, the cover art should not be included when the infobox is used in an article whose primary topic is not the album itself, such as a musician's biography of discography. Album cover artwork may be scanned, or downloaded from another site such as AllMusic or Amazon.com. Note that whether you scan one yourself or copy it from another site, when uploading an image, you must tag it properly and follow non-free content usage guidelines where they apply. Whenever possible, prefer a version without stickers (like Parental Advisory, "As seen on TV", etc.) to display the artwork as intended by the artist. If you cannot find a cover image, just leave this field blank.

*Upload a copy of the album cover (as a non-free image under fair use if necessary). The image will always display in the infobox at a fixed size of 220px, regardless of the user's appearance preferences.
* Fill the template's {{para|cover}} field with the name of your file (the full image syntax is not needed here – just the file name with the extension).

If nothing is entered into this field, the article will be added to the tracking category [[:Category:Album infoboxes lacking a cover]]. The article will also be added to the category if one of the following values is used: <code>???</code>, <code>MissingImage.png</code>, <code>missingImage.png</code>. Setting the field to the value <code>blank</code> will leave the cover area empty without categorizing the article into the above category. This is useful if the cover does not exist, for example the album was not released yet, or the cover cannot be added due to other limitations.

===alt===
Alt text for the album cover, for visually impaired readers.

===released===
Original album release date ("December 14, 2003", without the quotation marks). If the day is unknown, indicate only month and year ("December 2003"); if the month is unknown indicate only the year ("2003"). Only the ''earliest'' known date that the album was released should be specified; later release dates (incl. re-issues) can be mentioned in a Release history section.

===recorded===
Enter the date(s) the album was recorded. When there are many dates, it is best to summarize, using the month or range of months (e.g., January–March 2023). For multiple entries, see Notes<ref name="flatlist">For multiple entries, format the items as a normal bulleted list; don't use other list templates or <nowiki><br/></nowiki>. For example:
<syntaxhighlight lang="wikitext">
| studio =
*First item
*Second item
*Third item
</syntaxhighlight>
will be displayed as a vertical unbulleted list:
{|style="border:1px solid #ccc"
|style="vertical-align:top"|'''Studio'''&nbsp;&nbsp;&nbsp;||{{unbulleted list|First item|Second item|Third item}}
|}
</ref> for details. Add the location of the recording in the {{para|studio}} or {{para|venue}} field.

===studio===
If the album was recorded in a '''recording studio''', enter the name and location. Link the studio, but not well-known cities, states, or countries. Remove "Studios" if it appears in the name - use <code><nowiki>[[Sound City Studios|Sound City]]</nowiki></code> rather than <code><nowiki>[[Sound City Studios]]</nowiki></code>. For multiple entries, see Notes<ref name="flatlist" /> for details. For "United States" and "United Kingdom", it is preferred that they be abbreviated "US" and "UK".

===venue===
For '''live recordings''', include the name of the venue (concert hall, stadium, etc.) and location. Link as appropriate. For "United States" and "United Kingdom", it is preferred that they be abbreviated "US" and "UK".

===genre===
The field should include the music genre(s) that best describes the album. It should come from a reliable source and also '''be stated and referenced''' in the body of the article; personal opinions or original research must not be included. Note that most genres aren't proper nouns, and shouldn't be capitalized, but the first word in the list should be. For multiple entries, see Notes<ref name="flatlist" /> for details.

===length===
Enter the length of the album in minutes and seconds, even if it is longer than one hour. Use a colon to separate the two, such as <code>71:09</code>; do not use "71 minutes and 9 seconds", 71' 9", 1:11:09, etc.  A seconds value must be included; enter "71:00" if the album is timed to 71 minutes only.

Usually, only the length of the ''original album release'' should be entered. The timing of reissues or other releases, such as with bonus tracks, should be added to a "Releases" or similar section in the main body of the article, if noteworthy. For albums that are released with multiple track listings simultaneously, only list the most common length or that of the standard edition of the album.

===label===
Only the record label that the album was originally released on should be specified.  Where significantly different versions have been released (featuring alternative track listings) e.g. in the US vs UK, the later release date or record label should be mentioned ''in the article'', for example in a Release history section. Drop words like "Records" from the end of the label's name (e.g. use <code><nowiki>[[Universal Records|Universal]]</nowiki></code> rather than <code><nowiki>[[Universal Records]]</nowiki></code>). For multiple entries, see Notes<ref name="flatlist" /> for details.

===producer===
Enter the name of the person(s) credited as the actual record producer(s). Do not include those listed as executive, co-, additional, vocal, etc., producers, unless a reliable source identifies their contribution as substantially the same as the main producers. These should be included in the article body or track listings rather than be listed here. For multiple entries, see Notes<ref name="flatlist" /> for details.

==Professional reviews==
Professional reviews may include only reviews written by professional music journalists or DJs, or found within any online or print publication having a (paid or volunteer) editorial and writing staff (which excludes personal blogs). The standard for inclusion always is that the review meet Weezerpedia's guideline for reliable sources and that the source be independent of the artist, record company, etc. Due to their proliferation and dubious value, lists (e.g. ''Rolling Stone's 100 Greatest Punk Rock Albums of the Early 1980s'') may not be included.

The reviews should be listed alphabetically in the <code>reviews</code> or  <code>song_reviews</code>field. Start each one on a new line, beginning with an asterisk (*). The first bit of info should be the name of the source (most commonly a magazine like ''Rolling Stone''—note that magazines are italicized).

The second bit should be the rating given in the review (e.g. 4/5). The rating should use the same format as in the review, to accurately portray the score of the review. For star ratings you should use the [[Template:Rating|star rating template]], for example, entering <code><nowiki>{{Rating|4.5|5}}</nowiki></code>, will render: {{Rating|4.5|5}}. 

The third bit is preferably a link to the actual review on an official page; it may also be a summary of the review located elsewhere (if the original publisher doesn't include it online). The link should display as the year that the review was published. If you cannot find the year of publication, the word ''link'' will suffice. If there are no online sources, you may include no link at all, but must then cite the information properly. The citation should include the full date of publication and preferably the page number.

Include no more than ten reviews. When choosing which reviews to include, consider the notability of the review source and keeping a neutral point of view. For older albums, try to include not just contemporary but also some more recent reviews.

==Chronology==
This group of fields establishes a timeline of an artist's releases. In general, all albums and EPs should be placed in a single, chronological chain in order of release date (singles have a [[Template:Infobox song|separate infobox]], and thus a separate chain). Exceptions may be appropriate for artists with very complex discographies which may warrant more than one chain. If the previous or next release has a Weezerpedia article, link the title to the corresponding article. Take care to maintain the integrity of chains, so that when release "A" points to "B" as the next release, "B" points back to "A" as the previous release.

It is recommended that years should not be linked within the chronology section. Cover images should not be included in the chronology, as that would not be non-free use.

No more than one album should be included in any of the three slots in the chronology. Some albums can be part of more than one chain, using an [[#Template:Extra chronology|"additional chronologies" section]].  Albums released on the same day should be listed separately, ordered using the standard ordering of those albums, or alphabetically if no such standard exists.

{{para|prev_title}} and {{para|prev_year}} specify the previous album in the chain and its title. If the current album is the first album in a chain, this field should be blank.

{{para|next_title}} and {{para|next_year}} specify the next album in the chain and its title. If the current album is the last album in a chain, this field should be blank.

At least one of the title fields must have a value filled in for the chronology to display. If the year displayed for the current article's album is incorrect, then it can be specified manually using {{para|year}}.

==Advanced usage==
{{Infobox album
| italic_title = no
| name       = Together
| type       = cover
| artist     = Diana Ross & the Supremes and The Temptations
| cover      = MissingImage.png
| alt        = Example image
| border     = yes
| caption    = Original LP cover
| released   = Spetember 23, 1969
| recorded   = 1969
| venue      =
| studio     =
| genre      = Pop, [soul
| length     =
| label      = Motown
| producer   = Frank Wilson, Smokey Robinson, Al Clevland, Terry Johnson, Tom Baird, Henry Cosby, Deke Richards
| chronology = The Supremes
| prev_title = Let the Sunshine In
| prev_year  = 1969
| next_title = Cream of the Crop
| next_year  = 1969
| misc       = {{Extra chronology
 | artist     = The Temptations
 | type       = cover
 | prev_title = Puzzle People
 | prev_year  = 1969
 | title      = Together
 | year       = 1969
 | next_title = On Broadway
 | next_year  = 1969
 }}
 {{Extra album cover
 | type          = cover
 | cover         = MissingImage.png
 | alt           = Example alt text
 | border        = yes
 | caption       = The original American LP for ''Together'' has a cover which folds out to reveal a full illustration of The Supremes and The Temptations. The full artwork was also used for some international versions of the album without requiring the cover to be unfolded.
 }}
 {{Singles
 | name        = Together
 | type        = cover
 | single1     = The Weight
 | single1date =
 | single2     = Why (Must We Fall in Love)
 | single2date =
 }}
}}
In special situations, additional fields may be applicable. Unused fields may be either left blank or deleted.
<syntaxhighlight lang="wikitext" style="line-height:1.2em;">
{{subst:Infobox album
| italic_title = 
| name         = 
| type         = 
| longtype     = 
| artist       = 
| cover        = 
| border       = 
| alt           = 
| caption       = 
| released      = 
| recorded      = 
| venue         = 
| studio        = 
| genre         = 
| length        = 
| language      = <!-- Do not use for English albums by English-speaking artists -->
| label         = 
| director      = 
| producer      = 
| compiler      = 
| riaa          =
| reviews       =
| metascore     =
| song reviews  =
| chronology    = 
| prev_title    = 
| prev_year     = 
| year          = 
| next_title    = 
| next_year     = 
| misc          = 
}}
</syntaxhighlight>

===italic_title===
Titles that are rendered in italics in running prose are also displayed in italics in the page title. By default, the infobox achieves this automatically for album articles. If the page title is not the album title, as when only a section is devoted to an album, and in unusual cases where the title would not be italicized in running prose, such as [[Unreleased Christmas EP]], set this parameter to "no" to prevent the page title from being italicized. This will also omit italics in the infobox heading. Use <code><nowiki>|italic_title = no |name = {{yesitalic|</nowiki>''name of album''<nowiki>}}</nowiki></code> to get italics in the infobox heading but not the page title.

===longtype===
This field can be used if you wish to include information such as the title of the film that an album is the soundtrack to, or the name of the artist that a tribute album is in honor of. The text in this field appears between the type and the word "by".

===border===
Choosing "yes" here will insert a 1px grey border around the cover image. This is useful for instances where the image and the background will blend together.

===caption===
If the album has been issued with different front covers, which version the image refers to should be noted here.

===language===
This field should identify what language(s) are used in the lyrics of the album. Do not forget to [[Wikipedia:Disambiguation|disambiguate]] and [[Wikipedia:Piped link|pipe link]] when necessary. For example, if an album's lyrics are in English and French, you would use <code><nowiki>English, French</nowiki></code>. Do not use this field for albums entirely in the English language, by English-speaking artists.

===director===
This field is only applicable to |video albums. The name of the director should be linked to the corresponding article. For multiple entries, see Notes<ref name="flatlist" /> for details.

===compiler===
This field is only applicable to compilation albums of any kind where the person or entity responsible for selecting the album's track listing is known.  For multiple entries, see Notes<ref name="flatlist" /> for details.

===riaa===
This field is used when an album or a song has been certified by the '''Recording Industry Association of America (RIAA)'''. It should only be used with the {{tl|Riaa}} template to ensure proper formatting and display of certification icons. When included in the infobox, this field will display an icon corresponding to the album's or song's RIAA certification level. 

This field should only be used when an official RIAA certification has been awarded. If the album or song has not been certified, exclude this field.

===metascore===
This field is used when an album or a song has received a '''Metascore''' from [https://metacritic.com Metacritic.com]. It should only be used with the {{tl|Metascore}} template to ensure proper formatting and display of the score. When included in the infobox, this field will display an icon corresponding to the album's or song's Metacritic score.

This field should only be used when an official Metascore has been published. If no score is available, exclude this field.

===chronology===
This field can be used when the album belongs to an overall series that is not adequately described by the artist's name alone; in these situations, the text entered in this field replaces the artist name (from {{para|artist}}) that would normally be displayed preceding "chronology". Examples include series of compilation albums compiled by different people, and series of soundtracks (which are often "various artists" collections).

===misc===
A number of templates exist that can be inserted in the '''misc''' field, including {{tl|Extra album cover}}, {{tl|Extra chronology}} and {{tl|Singles}}. If you use any of these templates, don't forget to add a second set of closing brackets for the nested template. 

===={{Anchor|Template:Extra chronology}} Template:Extra chronology====
Additional chronologies are generally useful for [[split album]]s, collaborative albums, and series of albums.

<syntaxhighlight lang="wikitext" style="overflow:auto">
{{Infobox album
...
| misc       = {{Extra chronology 
 | artist     = 
 | type       = 
 | prev_title = 
 | prev_year  = 
 | title      = 
 | year       = 
 | next_title = 
 | next_year  = 
 }}
}}
</syntaxhighlight>

The '''artist''' field should be the artist that this additional chronology reflects, for example one of the artists on a split album. The '''type''' field should contain the same type as the rest of the infobox. The format of the other fields is the same as the standard chronology (see [[#Chronology|above]]).


===={{Anchor|Template:Extra album cover}} Template:Extra album cover====
If the album has been released with different album covers, they can be added to the infobox using this template. An alternative cover that is significantly different from the original and is widely distributed and/or replaces the original has generally been held to pass this criterion. Also, an alternative cover that is the subject of specific (sourced) critical commentary passes the criteria for inclusion. Covers that are essentially similar, despite differences in colouring, poses, text, etc., should not be included.  

<syntaxhighlight lang="wikitext" style="overflow:auto">
{{Infobox album
...
| misc    = {{Extra album cover
 | header  = 
 | type    = studio
 | cover   = 
 | border  = <!-- optional parameter, type "yes" here to add a 1px border to the cover image -->
 | alt     = 
 | caption = 
}}
}}</syntaxhighlight>

The '''caption''' field allows for an optional explanatory text. It should mention where that cover was used (int'l release, re-release, censored original, etc.). As with the <nowiki>{{Extra chronology}}</nowiki> template, the '''type''' field should contain the same type as the rest of the infobox.

====Template:Singles====
The {{tl|Singles}} template may be used as a miscellaneous addition to the infobox providing concise information about songs on the album that were released as singles during the marketing and promotion of the album. Promotional activity for extremely popular albums may continue for a long time, and songs from the album may be released as singles a year or more after the album's initial release. For example, songs from the album ''Thriller'' were released as singles for more than a year after the release of the album, and such singles are considered to be from the album.

#Do not add specialty- or limited-release singles, such as those supplied to radio stations and music publications, which are often marked as "Promo copy" or "Promotional".
#Do not include singles that were added as bonus tracks on a re-release of an album.
#For songs that appear on more than one album, list the song as a single only for the album(s) where the single was released as part of the marketing and promotion of that album. Examples:
#*If a song is originally released as a single during the marketing and promotion of an album on which it also appears, and is subsequently included on a compilation album, list the song as a single only for the original album and not for the compilation album.
#*If a song is originally released as an album track only, but is subsequently released as a single to promote the release of a compilation album, include the song as a single only for the compilation album.

For complex release scenarios where it may not be obvious that a single was released as part of the marketing and promotion of the album on which it appears, seek consensus on the talk page for the album.

The output includes the name of the single and its release date, and the list should be in sequence by release date. This infobox should be placed in the "Misc" field as shown below, using the field cases also shown below. Any unused fields may be left out.

<syntaxhighlight lang="wikitext" style="overflow:auto">
{{Infobox album
...
| misc       = {{Singles
 | name        = 
 | type        = 
 | single1     = 
 | single1date = 
 | single2     = 
 | single2date = 
 | single3     = 
 | single3date = 
 | single4     = 
 | single4date = 
 }}
}}
</syntaxhighlight>

;name : The name of the album.
;type : The album type (as specified [[#Type and color|above]] in the section "type").
;single<var>#</var> : The name of the single. Should be wikilinked to the single's article, if applicable.
;single<var>#</var>date : The date of single release. If the full date is unknown, just use "Month Year" or "Year".

Note that all fields are already properly formatted, so italics or quotation marks need not be entered in fields.

==Notes==
<references />