Template:Video game reviews/doc#Guidelines

{{Documentation subpage}}

{{High-use}}

{{Lua sidebar}}

{{Uses Lua|Module:Video game reviews|Module:Video game reviews/data|Module:Video game wikidata}}

{{Uses TemplateStyles|Module:Video game reviews/styles.css}}

{{tld|Video game reviews}} is a template which presents review aggregator and individual publication review scores in a video game article. It supports a game's reception section, which for released titles is necessary for an article to be broad in its coverage.

Things to remember:

  • This template is not required.
  • This template supplements the reception section; it does not replace it.
  • Only include reviews if they are cited within the text.

Guidelines

= General rules =

  • {{tld|Video game reviews}} is not required. Traditional reviews, or those that provide some type of score, may be few and far between for some games. If you only have a couple of such reviews which could be used to fill the table, consider foregoing the table and instead simply state these in the body of reception text.
  • All reviews must be referenced. Individual reviews should cite their original publication, not the truncated aggregator summary. See also Wikipedia:WikiProject Video games/Sources.
  • Every single-site review source should be used within the reception section. The reviews table supports the text. It is not to replicate the function of external review aggregators.
  • Stay with the "{{vanchor|usual suspects}}".

= {{anchor|Aggregators}}Aggregator scores =

{{Shortcut|WP:VGAGG}}

Aggregators present readers with a quick gauge of the critical consensus.

  • Metacritic − Industry standard
  • GameRankings − Useful for older games
  • : Do not include GameRankings in articles about newer games. GameRankings is mainly useful for older games and it is mainly duplication in newer ones. Round aggregator scores to the nearest whole number (e.g., {{!xt|83.46%}} → {{xt|83%}}).
  • OpenCritic − Useful for newer games.
  • : Only use OpenCritic's Critics Recommend metric normally. Do not include OpenCritic's Top Critic Average metric in articles that have a Metacritic score.

= Review scores =

The following sources comprise the most popular and influential voices in the games industry. They provide a core selection of reviews to build a reception section:

  • IGN − Most popular English language games website
  • GameSpot − Second most popular English language games website
  • Game Informer − US magazine with the largest circulation
  • Edge − UK's longest running print magazine
  • Eurogamer − Most popular European English language games website

For older games, particularly fifth generation and earlier, web based publications lacked the reach and influence of print publications. Consider these sources:

Single platform publications may offer specialist insight to platform-exclusive games, and allow readers to compare the reception across platforms of multiplatform games. Consider sources such as Nintendo Power, Official Xbox Magazine, PC Gamer, PlayStation Official Magazine – UK, and others.

For niche genres, genre publications may offer specialist insight. Consider sources such as Adventure Gamers, RPGamer, PC Pilot, and others.

Games which have strong cultural ties to their country of origin should have reception from that same country. Japanese games and Japanese ports of American games, for example, are best served with a Famitsu review (See below).

Consider coverage from outside traditional video games media. High quality sources such as The New York Times, Wired, and the BBC do not cater to a "gamer" audience, but may on occasion cover video games. Wikipedia is both a generalist and specialist encyclopedia. Opinions from these sources may be more accessible to a non-gamer audience and place the subject in a greater cultural and societal context than is possible at a narrowly focused video gaming publication.

{{Anchor|aggscore}}Consider the aggregate scoring breakdown. The review aggregators used in the table are considered reliable sources and are trusted to provide the critical consensus. However, some games may divide opinion and there may be no true consensus. This division of opinion may already have been captured following the guidelines above, but if not - consider including further reviews expressing these "outlier" opinions.

== Scoring systems ==

  • {{Anchor|noscore}}Reviews without scores: Some publications, such as Kotaku and Polygon, may not score their reviews. If, instead of a score, the publication presents the game with a badge or award in its review, this can be included in the table. This is not necessary.
  • Collective scoring: Publications such as Electronic Gaming Monthly and Famitsu review games among a group, with each reviewer offering their individual score. Using the average or cumulative score from these publications will result in the loss of that breakdown, so include the individual scores, either in the table itself or in a footnote.
  • Numerical scores: Make sure to include the maximum possible score for a review if the review uses a numerical value ("7/10", "86/100"). This is not required if the score is published as a percentage, as this presumes the maximum score of 100%.
  • Letter grades: Ratings that use a letter grade system should simply present the letter grade ("B-", "C+").
  • {{Visible anchor|Stars}}: If a review uses a star rating, convert it to the numerical value ("3.5/5" but not "{{rating|3.5|5}}"). The {{tl|rating}} using has been discarded.
  • Individual component ratings: If a review scores components of a game separately (but does not give an overall score) e.g Graphics 3/5, Sound 4/5, Gameplay 5/5 etc, add all the components together to reach a single score like 12/15, and add a footnote listing the individual scores.

General

= Usage =

All of the following fields are optional:

; title*

: Can be used to provide a custom title for the table; otherwise, it will default to "Reception".

; subtitle*

: Used to add additional text before the collapsible section. This is necessary to add if want a longer title, as long titles via the "title" parameter will not center correctly.

; state* [autocollapse, collapsed, expanded]

: autocollapse  –  The table will start out collapsed if there are two or more tables on the same page that use other collapsible tables. Otherwise, the table will be expanded. For technical details, see MediaWiki:Common.js.

: collapsed  –  The table will be collapsed (hidden) by default. This is useful for very long tables.

: expanded  –  The table will be expanded (shown) by default. This is useful if autocollapse is not showing the table in a section that it wouldn't matter.

: If undefined or set to blank, the table will not be collapsible. The table will also not be collapsible if the title parameter is not set.

; align*

: right  –  Displays the table on the right. This is default.

: left  –  Displays the table on the left.

: inherit  –  Specifies that the value of the float property should be inherited from the parent element.

: none  –  The table is not aligned, and will be displayed just where it occurs in the text on the page.

; qid

: Can be used to link to a different Wikidata QID than the current page. Specifying 'none' will disable Wikidata pull entirely.

; df

: Can be used to specify the date format for any generated citations from Wikidata.

= Code =

class="wikitable sortable"
scope="col" | Aggregator

! scope="col" | Code

! scope="col" class="unsortable" | Example

MetacriticMC83/100
GameRankings
(See note above—only use when Metacritic data is unavailable)
GR84%
OpenCritic
(See note above—only use OpenCritic Top Critic Average if Metacritic data is unavailable)
OC96% recommend

Use "wikidata" as the rating for the above fields to pull from aggregator reviews declared on the game's respective Wikidata page. This will automatically build references from Wikidata as well. The default date format is MDY. To change it, specify another format with "|df=" such as DMY, YMD, etc. See WP:VG/WD for a quick guide on editing Wikidata.

{{div col|colwidth=22em}}

{{div col end}}

Award layout

= Usage =

{{Video game reviews

| title = Documentation Template

| subtitle = For testing

| state = expanded

| award1 = PC Game of the Year (2000)

| award1Pub = BAFTA

| award2 = Best PC Game of All Time

| award2Pub = PC Zone

}}

{{template shortcut|VG Awards|Video game awards}}

:; awardn*

:: These are for the title of the awards that the game has won.

:; awardnPub*

:: These are the publishers that provided the award for the game.

= Code =

Example Blank Template

{{Video game reviews

| title =

| subtitle =

| state =

| align =

| award1Pub =

| award1 =

| award2Pub =

| award2 =

}}

Single-platform/column layout

{{Video game reviews

| title = Documentation Template

| subtitle = For testing

| state = expanded

| 1UP = PS4/XONE: C
PSP: C-

| EGM = PS4/XONE: C, C, B-

| GI = PS4/XONE: 8.75/10

| GSpot = 3DS: 5.5/10
PS3: 6.0/10
PS4/XONE: 7.5/10
VITA: 7.0/10
NS: 6.0/10

| GT = PS4/X360: 6.9/10

| IGN = PS3: 7.2/10
VITA: 7.5/10
PS4/XONE: 7.3/10
NS: 7.8/10

| OXM = 7.5/10

| XPlay = PS4/XONE: 2/5

| MC = 3DS: 61/100
PS3: 68/100
PS4: 70/100
VITA: 70/100
NS: 70/100
XONE: 73/100

| rev1 = Custom Reviewer

| rev1Score = With score

| rev3 = Other Custom Reviewer

| rev3Score = Can skip numbers

| award1 = PC Game of the Year (2000)

| award1Pub = BAFTA

| award2 = Best PC Game of All Time

| award2Pub = PC Zone

}}

= Usage =

; awardn*

: These are for the title of the awards that the game has won.

; awardnPub*

: These are the publishers that provided the award for the game.

; revn*

: These are for custom reviewers. Use with revnScore.

; revnScore*

: These are for custom reviewers scores for each Platform. Use with revn.

; aggn*

: These are for custom aggregate. Use with aggnScore.

; aggnScore*

: These are for custom aggregate scores for each Platform. Use with aggn.

= Code =

Example Blank Template

{{Video game reviews

| title =

| subtitle =

| state =

| align =

| MC =

| XPlay =

| IGN =

| agg1 =

| agg1Score =

| agg2 =

| agg2Score =

| rev1 =

| rev1Score =

| rev2 =

| rev2Score =

| award1Pub =

| award1 =

| award2Pub =

| award2 =

}}

Multi-platform/column layout

= Usage =

{{Video game reviews

| title = Documentation Template

| subtitle = For testing

| state = expanded

| na = true

| 3DS = true

| PC = true

| PS4 = true

| NS = true

| MC_3DS = 71/100

| MC_PS4 = 91/100

| 1UP_3DS = B

| GSpot_3DS = 7.9/10

| GSpot_PC = 7.2/10

| GSpot_PS4 = 8.2/10

| GSpot_NS= 7.3/10

| IGN_3DS = 7.0/10

| IGN_PS4 = 8.7/10

| GSpy_3DS = {{Rating|2.5|5}}

| rev1 = Custom Reviewer

| rev1_3DS = With score

| rev3 = Other Custom Reviewer.

| rev3_PC = Can skip numbers.

| award1 = PC Game of the Year (2000)

| award1Pub = BAFTA

| award2 = Best PC Game of All Time

| award2Pub = PC Zone

}}

:; na*

:: This will set a fill of N/A grayed out.

:; awardn*

:: These are for the title of the awards that the game has won.

:; awardnPub*

:: These are the publishers that provided the award for the game.

:; revn*

:: These are for custom reviewers. Use with revnPlatform.

:; revnPlatform*

:: These are for custom reviewers scores for each Platform. Use with revn.

= Code =

You first need to put any platforms that are being used.

The code to use is as follows:
Enter "true" into any platform used.
If not used, set to non-true value, leave blank, or delete the parameter.

style="background:transparent;width:100%;" cellpadding="16"
style="vertical-align:top;"

| rowspan=2 |

Example Blank Template

{{Video game reviews

| title =

| subtitle =

| state =

| align =

| na = true/false; default is false and can be omitted

| DS = true

| iOS = false

| MC_DS =

| MC_iOS =

| XPlay_iOS =

| IGN_X360 =

| rev1 =

| rev1_PC =

| rev1_X360 =

| rev2 =

| rev2_PC =

| award1Pub =

| award1 =

| award2Pub =

| award2 =

}}

{| class="wikitable sortable" width="67.5%"

|+ {{vanchor|Common predefined system types, see #How to add a new platform for all}}

! style="width:220px" | System

! style="width:55px" | Code

3DO Interactive Multiplayer3DO
Nintendo 3DS3DS
AmigaAMI
Arcade gameARC
Atari 2600A2600
Atari JaguarJAG
Atari LynxLYNX
Atari STAST
Commodore 64C64
Amiga CD32CD32
ColecoVisionCV
MS-DOSDOS
DreamcastSDC
Nintendo DSDS
Game BoyGB
Game Boy AdvanceGBA
Game Boy ColorGBC
GameCubeNGC
General ~~ If review is broad.GEN
IntellivisionINT
iOSiOS
MacintoshMAC
Master SystemSMS
Mobile phonesMOB
N-GageN-G
Nintendo 64N64
Nintendo Entertainment SystemNES
Nintendo SwitchNS
Personal computerPC
PlayStation VitaVITA
PlayStationPS
PlayStation 2PS2
PlayStation 3PS3
PlayStation 4PS4
PlayStation 5PS5
PlayStation PortablePSP
Sega SaturnSSAT
Sega GenesisSMD
Sega Game GearSGG
Nvidia ShieldNSHI
Super Nintendo Entertainment SystemSNES
TurboGrafx-16TG16
VIC-20VIC
WiiWII
Wii UWIIU
XboxXBOX
Xbox 360X360
Xbox OneXONE
Xbox Series X and Series SXSXS
ZX SpectrumZX

|}

How to add a new platform

Go to Module:Video game reviews/data and add {'wiki url/title', 'short code for the system'} within the system array.

  • Define a code for the new platform, such as "PS2" for PlayStation 2.
  • Determine its alphabetical order, and the platform code preceding and succeeding it. For example, for PS2, the PS precedes, and the PS3 succeeds.

How to add a new reviewer

Go to Module: Video game reviews/data and add {'wikilink/title', 'short code for the reviewer'} within the reviewer array.

  • Define a code into the appropriate place (alphabetically) of the existing code.
  • Provide an appropriate wikilink if available.

Template Data

{{notice|This template data section contains only key parameters.}}

{{TemplateDataHeader}}

{

"description": "A template to show the review scores, aggregator scores, and awards given to a title.",

"params": {

"title": {

"label": "title",

"description": "Title of the template.",

"type": "string",

"default": "Reception",

"required": false

},

"subtitle": {

"label": "subtitle",

"description": "Subtitle of the template.",

"type": "string",

"required": false

},

"state": {

"label": "state",

"description": "The tables collapsable settings.",

"type": "string",

"default": "expanded",

"required": false,

"suggestedvalues": [

"autocollapse",

"collapsed",

"expanded"

]

},

"align": {

"label": "align",

"description": "The tables horizontal alignment settings.",

"type": "string",

"default": "right",

"required": false,

"suggestedvalues": [

"left",

"right",

"inherit",

"none"

]

},

"na": {

"label": "na",

"description": "This will set a fill of N/A grayed out.",

"type": "string",

"default": "true",

"required": false

},

"GR": {

"label": "GameRankings",

"description": "Only use for older games when Metacritic data is unavailable",

"type": "string"

},

"OC": {

"label": "OpenCritic",

"description": "Only use the Critics Recommend metric. The Top Critic Average should be omitted when Metacritic data is available",

"type": "string"

},

"MC": {

"label": "Metacritic",

"type": "string"

},

"1UP": {

"label": "1Up.com",

"description": "A+ to D-",

"type": "string",

"required": false

},

"ACE": {

"label": "ACE",

"type": "string",

"required": false

},

"AdvGamers": {

"label": "Adventure Gamers",

"type": "string",

"required": false

},

"Allgame": {

"label": "AllGame",

"type": "string",

"required": false

},

"AAction": {

"label": "Amstrad Action",

"type": "string",

"required": false

},

"Amtix": {

"label": "Amtix",

"type": "string",

"required": false

},

"CVG": {

"label": "Computer and Video Games",

"description": "9.2/10 (0 to 10)",

"type": "string",

"required": false

},

"CGM": {

"label": "Computer Games Magazine",

"type": "string",

"required": false,

"aliases": [

"CGSP",

"cdmag"

]

},

"CGW": {

"label": "Computer Gaming World",

"type": "string",

"required": false

},

"CP": {

"label": "Consoles +",

"type": "string",

"required": false

},

"CRASH": {

"label": "Crash",

"type": "string",

"required": false

},

"Destruct": {

"label": "Destructoid",

"type": "string",

"required": false

},

"DT": {

"label": "Digital Trends",

"type": "string",

"required": false

},

"Dragon": {

"label": "Dragon",

"type": "string",

"required": false

},

"Edge": {

"label": "Edge",

"description": "6/10 (1 to 10)",

"type": "string",

"required": false

},

"EGM": {

"label": "Electronic Gaming Monthly",

"description": "9.5/10 (0 to 10)",

"type": "string",

"required": false

},

"EuroG": {

"label": "Eurogamer",

"description": "1 to 10 (1999–2015), no scores (2015–2023), 1 to 5 (2023–present)",

"type": "string",

"required": false

},

"Fam": {

"label": "Famitsu",

"description": "0 to 40",

"type": "string",

"required": false

},

"G4": {

"label": "G4",

"type": "string",

"required": false

},

"GI": {

"label": "Game Informer",

"type": "string",

"required": false

},

"GameFan": {

"label": "GameFan",

"type": "string",

"required": false

},

"Gamekult": {

"label": "Gamekult",

"type": "string",

"required": false

},

"GamePro": {

"label": "GamePro",

"type": "string",

"required": false

},

"GameRev": {

"label": "GameRevolution",

"description": "A to D- (1996–2012)",

"type": "string",

"required": false

},

"GMaster": {

"label": "GamesMaster",

"type": "string",

"required": false

},

"GSpot": {

"label": "GameSpot",

"description": "7/10 (1 to 10)",

"type": "string",

"required": false

},

"GSpy": {

"label": "GameSpy",

"type": "string",

"required": false

},

"GRadar": {

"label": "GamesRadar+",

"type": "string",

"required": false

},

"GStar": {

"label": "GStar",

"type": "string",

"required": false

},

"GTM": {

"label": "GamesTM",

"type": "string",

"required": false

},

"GT": {

"label": "GameTrailers",

"type": "string",

"required": false

},

"GameZone": {

"label": "GameZone",

"type": "string",

"required": false

},

"GB": {

"label": "Giant Bomb",

"type": "string",

"required": false

},

"Hyper": {

"label": "Hyper",

"type": "string",

"required": false

},

"IGN": {

"label": "IGN",

"description": "9.5/10 (1 to 10)",

"type": "string",

"required": false

},

"IW": {

"label": "Impress Watch",

"type": "string",

"required": false

},

"JXV": {

"label": "Jeuxvideo.com",

"description": "16/20 (1 to 20)",

"type": "string",

"required": false

},

"Joystiq": {

"label": "Joystiq",

"description": "Ceased scoring reviews in January 2015",

"type": "string",

"required": false

},

"JP": {

"label": "Joypad",

"type": "string",

"required": false

},

"MG": {

"label": "M! Games",

"type": "string",

"required": false

},

"MF": {

"label": "Mega Fun",

"type": "string",

"required": false

},

"MaxPC": {

"label": "Maximum PC",

"type": "string",

"required": false

},

"N64": {

"label": "N64 Magazine",

"type": "string",

"required": false

},

"NGen": {

"label": "Next Generation",

"description": "5-star rating",

"type": "string",

"required": false

},

"NG": {

"label": "NGamer",

"type": "string",

"required": false

},

"NGC": {

"label": "NGC Magazine",

"type": "string",

"required": false

},

"NLife": {

"label": "Nintendo Life",

"description": "10-star rating",

"type": "string",

"required": false

},

"NME": {

"label": "NME",

"type": "string",

"required": false

},

"NP": {

"label": "Nintendo Power",

"type": "string",

"required": false

},

"NWR": {

"label": "Nintendo World Report",

"type": "string",

"required": false

},

"ONM": {

"label": "Official Nintendo Magazine",

"type": "string",

"required": false

},

"OPMAU": {

"label": "PlayStation Official Magazine – Australia",

"type": "string",

"required": false

},

"OPMUK": {

"label": "PlayStation Official Magazine – UK",

"type": "string",

"required": false

},

"OPM": {

"label": "Official U.S. PlayStation Magazine",

"type": "string",

"required": false

},

"OXMUK": {

"label": "Official Xbox Magazine(UK)",

"type": "string",

"required": false

},

"OXM": {

"label": "Official Xbox Magazine(US)",

"type": "string",

"required": false

},

"PALGN": {

"label": "PALGN",

"type": "string",

"required": false

},

"PCF": {

"label": "PC Format",

"type": "string",

"required": false

},

"PCGUK": {

"label": "PC Gamer(UK)",

"type": "string",

"required": false

},

"PCGUS": {

"label": "PC Gamer(US)",

"description": "72/100",

"type": "string",

"required": false

},

"PCPP": {

"label": "PC PowerPlay",

"type": "string",

"required": false

},

"PCZone": {

"label": "PC Zone",

"type": "string",

"required": false

},

"PCG": {

"label": "PC Games (DE)",

"type": "string",

"required": false

},

"PCGN": {

"label": "PCGamesN",

"type": "string",

"required": false

},

"Play": {

"label": "Play",

"type": "string",

"required": false

},

"PG": {

"label": "Pocket Gamer",

"type": "string",

"required": false

},

"Poly": {

"label": "Polygon",

"description": "Ceased scoring reviews in May 2018",

"type": "string",

"required": false

},

"PSM": {

"label": "PlayStation: The Official Magazine",

"type": "string",

"required": false

},

"PSM3": {

"label": "PSM3",

"type": "string",

"required": false

},

"RPG": {

"label": "RPGamer",

"type": "string",

"required": false

},

"RPGFan": {

"label": "RPGFan",

"type": "string",

"required": false

},

"SN": {

"label": "Shacknews",

"type": "string",

"required": false

},

"SUser": {

"label": "Sinclair User",

"type": "string",

"required": false

},

"TX": {

"label": "TeamXbox",

"type": "string",

"required": false

},

"TR": {

"label": "TechRadar",

"type": "string",

"required": false

},

"TOT": {

"label": "Total!",

"type": "string",

"required": false

},

"TA": {

"label": "TouchArcade",

"type": "string",

"required": false

},

"USG": {

"label": "USgamer",

"description": "5-star rating",

"type": "string",

"required": false

},

"VB": {

"label": "VentureBeat",

"type": "string",

"required": false

},

"VG": {

"label": "VideoGamer.com",

"type": "string",

"required": false

},

"VGC": {

"label": "Video Games Chronicle",

"type": "string",

"required": false

},

"VGS": {

"label": "Video Games (DE)",

"type": "string",

"required": false

},

"XPlay": {

"label": "X-Play",

"type": "string",

"required": false

},

"YSinclair": {

"label": "Your Sinclair",

"type": "string",

"required": false

},

"Z64": {

"label": "Zzap!64",

"type": "string",

"required": false

}

},

"format": "block"

}

See also

{{Sandbox other||

Category:Rating templates

Reviews

Category:Metacritic templates

}}