Skip to content

Badge and Icon Guidelines


When someone mentions badges, they could be talking about one of two things:

  • Achievement badges, which are user-created images associated with the individual achievements of a set.
    • Sonic the Hedgehog's first Badge - #00199)
      • Amateur Collector Badge
  • Game icons, also known as mastery badges, which is a single image used to represent an achievement set.
    • Sonic the Hedgehog's game icon
      • Sonic the Hedgehog Icon

Badge Format and Sizes

  • For best results, game icons and achievement badges should be in 32-bit non-interlaced PNG format.
    • JPG and GIF are also supported.
  • Avoid using transparency in the background layer since it will not display properly on the site and emulators.
  • Achievement badges must be 64x64.
  • Game icons must be 96x96.
  • Badges should be made in a way that the subject is clear even when scaled down to 48x48 or 32x32, as they often are on various pages on the site.

Designing New Badges

Achievement badges should refer in some way to what the achievement is about - i.e. a picture of the boss, level or collectible that the achievement requires the player to get to.

Designing New Game Icons

Game Mastery Icons must represent the associated game by using 'Official' art only.

  • Sprites from the game (or models)
  • Box Art / Regional Box Art
  • Concept Art
  • CD / OST Art
  • Manual Art
  • Guidebook Art
  • Advertisements
  • Or any other 'Official' Source of artwork.

Mastery Icons must not

  • Use art from a different port
  • Use fan art sourced from external sources
  • Contain anything vulgar, offensive or pornographic

Mastery Icons may

  • Add in custom borders or other adornments
  • Stylize official art or combine different official art sources
  • Use official art from a different regional release on the same console, unless that regional release has its own game page entry
  • Use fan art created by the icon creator, but it must be approved by the art team prior to uploading or any icon gauntlet vote.


  • If two different ports use the same key art, that art may be used for either port.
  • Hacks - Most hacks use the same sprites from its source game. Other art that represents the game in a meaningful way may be used as long as it is not on the excluded list above (such as external fan art). Art by the developer of the hack may also be used.
  • Movie-Licensed/Movie Tie-In Games may use artwork that was used to promote the movie.

mario time

Uploading Game Icons


  • Achievement Developers are allowed to change game icons freely for entries that do not have achievements. As a Developer if you'd like to post a backup of the previous image there, if there is one, or backup yours in the forum you're free to but not required. As you create a new set of achievements you are free to create or choose the image you'd like to use as the game icon.
    • To change a game icon first go to the game page and click on the Dev tools:
      change game icon 1 - Then click the choose file button highlighted. Find the file on your PC, and then press the submit button highlighted:
      change game icon 2

If a game has existing achievements, game icon changes need to go through revision process.


Uploading Badges

For Developers:

If you are creating new achievements you are free to upload badges for them.

Badges are uploaded from within the emulator developer tools while in the achievement editor:

Or you can select a prefabricated image or find other images you've uploaded in the drop down box:

Badge Server Files

  • Game icons are stored on the site in the following manner and place: They are stored in the same server folder as other game images such as the game box and game screenshots.
  • Achievement badges are stored on site in the following manner and place:; the number coincidences with the badge ID found in the Achievement.

Making New Badges for Existing Achievements

If you'd like to make improved badges for existing achievements, you can. Your images will go through the revision process, which will put your creations to a community vote.

Post all the new images you'd like to replace current ones in the Icon Gauntlet Forum Topic. Also post all the badges that the new images are meant to replace. They will be placed for a community review by as a single vote. After a community vote is complete if you are a dev you can replace the Badges or if you are not, ask for help in the #help-me channel on Discord or in the Icon Gauntlet Forum Topic.

It's easiest to just reference the old and new Badges as img links:

  • Example: [img=] -> [img=]
  • (Dev) Make sure to capture the old Badge ID from the Achievement Editor before uploading the new Badge
  • The new Badge ID will appear in the Achievement Editor after uploading it.
  • Both values can also be captured from the web site, but you have to copy the image links as the hover link is for the achievement.

Here is a perfect example of how to effectively post new and old Badges.

To Do

  • Needs info on adding achievement badges via the website.
  • Add "collager" info.

Released under the GPL-3 License. There are no copyright-protected ROMs available for download on RetroAchievements.