File Standards Guide

From Liquipedia Commons Wiki

Liquipedia has a few set standards of file sizes and types for different uses.

Recent Changes[edit]

  • September 2021
    • Tournament logos are being integrated into the new standard as with team logos previously
    • Tournament icons (dubbed "league icons") are being scrapped in favor of dynamically generated thumbnail versions.
    • A single unified file may be able to act as the logo for the infobox and icon locations going forward.
    • Icon variants (if required) will be uploaded in full resolution rather than 50x50px or 100x100px.
    • Logos for both the darkmode will be uploaded along with logos for our current light theme.
    • File naming standard is being clearly specified and enforced.
  • April 2021
    • Team logo "std" files are being phased out entirely and should no longer be created.
    • A single unified file is going to act as the logo for team templates and team cards going forward.
    • Logos for both the darkmode will be uploaded along with logos for our current light theme.
    • File naming standard is being clearly specified and enforced.

Tournament/Series Logos & Icons[edit]

Image/Canvas Size[edit]

  • The canvas size must be at least 336 pixels wide and should be at least 672 pixels wide.
  • It is recommended to make the shorter side of the canvas at least 1000px — A lot of TOs and Teams source logos from us.
  • Keeping the shorter side to a round number such as 1000px (as opposed to 996px for example) is also recommended.
  • The logo must fill the entire canvas with no empty space ("whitespace") on any sides.
    • The only exception to the above rule is for the purpose of centering a logo on the canvas (ESL Adria League example below [see left side of canvas]).
  • The canvas must be fully transparent outside of logo itself (i.e., no background colors, graphics, glows, shadows, or gradients).
    • The only exception to the above rule is if the logo cannot be obtained without background graphics; in that case, the new naming scheme must also not be used.

Correct Examples[edit]

Incorrect Examples[edit]

Light/Dark Background Suitability[edit]

  • Logo color scheme/variant must be suitable for the applicable background color (light mode/dark mode/both).
  • If the primary color/variant is suitable for both light & dark modes then it is recommended to use that variant for both.
  • If not, you must use the applicable colors/variants of the logo for the respective theme.
  • If no variant exists for one of the themes, you should attempt to invert the logo's incompatible elements (e.g. invert white to black for dark mode version).
  • Please ignore canvas sizes/padding for examples below, they are only to illustrate color/variant correctness.

Correct Examples[edit]

Incorrect Examples[edit]


Note: The examples are incorrect as they feature portions which are hard to see because they lack contrast with the background (i.e., white text on light background or vice-versa).

Primary vs Textless Variants[edit]

  • Tournament logos uploaded for use in the infobox should be the full logo of the tournament (rather than icon/simplified versions).
    • The only exception to the above rule is if the full logo (in an acceptable quality) of a tournament cannot be obtained but an icon/simplified version can be obtained.
  • The icon/simplified logos of tournaments should also be uploaded separately if they are different from the main logo described above.
    • The logo must no longer be uploaded in a small size (i.e., 50x50px or 100x100px) but should be uploaded in its original (within reason) size.
    • Any old style icons may be updated on top of the existing file as icons will be manually adapted to the new size by the server.
  • The primary logo should be used in infoboxes and the icon/simplified variant (if applicable) should be used everywhere else (i.e., LeagueIconSmall templates, results lists, match lists, etc.).
  • Please ignore canvas sizes/padding for examples below, they are only to illustrate the two different logo types.

Primary Logos[edit]

Icon/Simplified Logos[edit]

Note: The DreamHack Open logo is shown as identical for both examples, therefore no "icon" file should be uploaded; the standard file should be used as the icon file too.

File Type & Naming Scheme[edit]

  • Files must be uploaded as MIME type image/png and with file type and filename extension .png
    • There are currently no exceptions to the above rule, but this may change in the future.
  • The filename must conform to the following style: Tournament/Series Name_Season/Historical Suffix_Logo Type_Theme Identifier.png
  • There must be a space character or underscore (they will be converted all the same) between each term in the file name.
  • The terms are explained below:
    • Tournament/Series Name – The full and correctly capitalized name of the tournament or tournament series (excl. any Season/Edition identifier).
    • Season/Historical Suffix – Suffix denoting season/edition (if logo contains season or numerical edition reference) or historicality (e.g. 2020/2021) of the logo.
    • Logo Type – Label specifying whether logo is a full primary logo (to be left blank) or a textless/icon logo (to be labelled icon).
    • Theme Identifier – Label specifying whether logo is for both themes (allmode), the light theme (lightmode), or the dark theme (darkmode).

Correct Examples[edit]

  • DreamHack Open allmode.png
  • ESL One 2019 allmode.png
  • Fragadelphia 2021 darkmode.png
  • Fragadelphia 2021 icon allmode.png
  • Fragadelphia Inviational darkmode.png

Incorrect Examples[edit]

  • DH Open new.png – Not full tournament series name; missing theme identifier; historical suffix is poorly named; should be DreamHack Open 2021 allmode.png
  • ESL One infobox.jpg – Incorrect logo type label; wrong file format; missing theme identifier; should be ESL One allmode.png
  • Fragadelphia dark std.png – Theme identifier is wrong; using wrong/deprecated "std" logo format; should be Fragadelphia icon darkmode.png
  • Esl premiershiplogo darkmode.gif – Tournament series name wrong capitalization; erroneous "logo" stuck to name; wrong file format; should be ESL Premiership darkmode.png
  • ESL One full 2019.png – Theme identifier is missing; using wrong "full" logo format; should be ESL One 2019 allmode.png

Team Logos[edit]

Team Logo Policy[edit]

A logo upload to Liquipedia must abide by the following rules:

  • It must be a logo. A logo, as defined by Wikipedia: "A logo [...] is a graphic mark, emblem, or symbol used to aid and promote public identification and recognition. It may be of an abstract or figurative design or include the text of the name it represents as in a wordmark." We abide by this definition, and would explicitly add: a photograph is not a logo.
  • It must not violate copyright. The entity represented by the logo should not be violating copyright by using said logo.
For more information, click here.

Image/Canvas Size[edit]

  • The canvas size must be at least 336 pixels wide and should be at least 672 pixels wide.
  • It is recommended to make the shorter side of the canvas at least 1000px — A lot of TOs and Teams source logos from us.
  • Keeping the shorter side to a round number such as 1000px (as opposed to 996px for example) is also recommended.
  • The logo must fill the entire canvas with no empty space ("whitespace") on any sides.
    • The only exception to the above rule is for the purpose of centering a logo on the canvas (Sharks Esports example below).
  • The canvas must be fully transparent outside of logo itself (i.e., no background colors, graphics, glows, shadows, or gradients).

Correct Examples[edit]

Incorrect Examples[edit]

Light/Dark Background Suitability[edit]

  • Logo color scheme/variant must be suitable for the applicable background color (light mode/dark mode/both).
  • If the primary color/variant is suitable for both light & dark modes then it is recommended to use that variant for both.
  • If not, you must use the applicable colors/variants of the logo for the respective theme.
  • If no variant exists for one of the themes, you should attempt to invert the logo's incompatible elements (e.g. invert white to black for dark mode version).
  • Please ignore canvas sizes/padding for examples below, they are only to illustrate color/variant correctness.

Correct Examples[edit]

Incorrect Examples[edit]

Primary vs Textless Variants[edit]

  • Logos uploaded for use in the team templates extension must not include any optional logotypes (text) and should only be the logomark (icon) of the team.
    • The only exception to the above rule is if the logo of a team is solely a logotype (text logo) or if the logotype is not optional and integrated into the logomark itself.
  • The full primary logos (usually logomark + logotype, but not always) of teams should also be uploaded separately if they are different from the logo described above.
  • The primary logo should only be used on team pages in the infobox and the textless (if applicable) logo must be used everywhere else.
  • Please ignore canvas sizes/padding for examples below, they are only to illustrate the two different logo types.

Textless/Icon Logos[edit]

Primary Logos[edit]

File Type & Naming Scheme[edit]

  • Files must be uploaded as MIME type image/png and with file type and filename extension .png
  • There are currently no exceptions to the above rule, but this may change in the future.
  • The filename must conform to the following style: Full Team Name_Historical Suffix_Logo Type_Theme Identifier.png
  • There must be a space character or underscore (they will be converted all the same) between each term in the file name.
  • The terms are explained below:
    • Full Team Name – The full and correctly capitalized name of the team.
    • Historical Suffix – Suffix denoting historicality of the logo; must match historical suffix of team template (optional for non-historical/initial logos).
    • Logo Type – Label specifying whether logo is a textless/icon logo (to be left blank) or a full primary logo (to be labelled full).
    • Theme Identifier – Label specifying whether logo is for both themes (allmode), the light theme (lightmode), or the dark theme (darkmode).

Correct Examples[edit]

  • Team Liquid allmode.png
  • Team Liquid 2020 allmode.png
  • Team Liquid 2020 darkmode.png
  • Ninjas in Pyjamas darkmode.png
  • Ninjas in Pyjamas full allmode.png

Incorrect Examples[edit]

  • Liquid lightmode teamcardimage.png – Not full team name; incorrect logo type label; should be Team Liquid lightmode.png
  • MIBR new infobox.jpg – Historical suffix is poorly named; incorrect logo type label; wrong file format; should be MIBR 2018 full allmode.png
  • MIBR dark std.png – Theme identifier is wrongly named; using retired "std" logo format; should be MIBR darkmode.png
  • MiBRlogo darkmode.gif – Team name wrong capitalization; erroneous "logo" stuck to team name; wrong file format; should be MIBR darkmode.png