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 followed.

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]

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