As discussed in the Marketplace Item Types and Categories article, Token Markers are small overlay icons that are available in the radial menu when you select any Token on the Tabletop. They help track information such as conditions and can differentiate between multiple copies of the same Token art.
Every Roll20 game comes with a default set of Token Markers, but with Token Marker Sets, a GM can replace the default Token Markers in their games with those provided by Token Marker Sets instead.
Image Dimensions and File Type for Token Markers
Image Dimensions: 512 pixels wide by 512 pixels tall.
When a Token Marker asset is displayed over the Token it will be rescaled to 48 by 48 pixels or 24 by 24 pixels depending on how many Token Markers are enabled at the same time over a Token.
File Type: You can use PNG, JPG, or single-frame GIF file types.
Note: Animated Token Markers are currently not supported, so if an animated GIF is uploaded, only the first frame of animation will be used.
Token Marker Design Recommendations
Test for Image Readability
Token Markers are rescaled to a much smaller size within the Roll20 Tabletop. It is important to test your Token Marker images in a Roll20 game to ensure that they are still readable overlaying a Token. If your image assets look muddy or their line weight is too thin to see once downscaled, the art set will not be approved for the Roll20 Marketplace.
15 Unique Asset Minimum Per Token Marker Set
We require that your Token Marker set has at least 15 unique image assets. This does not include color or translucency variants of the same piece of art. The best practice for the number of image assets to include in a Token Marker Set is roughly 25.
Token Marker Sets Must Be Downloadable
Partners can normally choose whether or not their Art Packs are downloadable after purchase. Custom Token Marker Libraries are organized outside of the Roll20 Art Library - a Token Marker Set must be Downloadable for this reason. The Customer will need to download the assets of a Token Marker Set and then manually upload the ones they wish to add to their Token Marker Library.
Token Marker Set Naming Policy
The Roll20 Marketplace takes both set names AND asset names into consideration when returning search results. API scripting can also call Token Markers so it is important that your naming conventions for the images are brief, clear, and descriptive. A Token Marker image named, "happy cloud", will be more easily found in search than another named "token-marker-63".