Token Variant Art

Latest version1.10.0
Minimum Core0.7.7
Compatible Core0.8.6
Last updated6 days ago
Created2 months ago
Languages English
Systems Dnd5e
Project source Project URL
Report bugs Bug tracker URL

Token Variant Art

This module provides a pop-up window upon token creation which displays all the available variants of the token art it could find in the customizable list of directories.

Art Select pop-up

The search is done using the Actor's name, and will ignore special characters, case, or spaces in the files


  • 'Mage' will match: 09_mage.png, red-MAGE-64.png, mage-s_fire.jpg
  • 'Half-Red Dragon Veteran' will match: HalfRedDragonVeteran.png, hAlF_rEd_dRAgon-VETERAN.png


The only requirement is that the full name of the Actor is present in the file name. So the following would not match:

  • 'Mage' will NOT match: mag03.png, 09_ma_abc_ge.png

  • 'Half-Red Dragon Veteran' will NOT match RedDragon.png, HalfRedDragon.png


The Art Select screen can also be opened up from the Actor Sheet by right-clicking on the portrait or Token Configuration window's Image tab. A new button is added right next to the File Picker:

Art Select button




Variant art search paths

The directories that will be scanned for art can be set here. All of the sub-directories will be searched as well so feel free to organise your art as you wish.

Search Paths

The root of these paths is assumed to be Foundry VTT's local Data folder. The same folder where you would find your worlds, systems, and modules.


By default 'Token Variants' will attempt to search Caeora's Maps, Tokens, and Assets asset folder if installed.


To specify a path for a configured AWS S3 bucket you can use the following format: s3:{bucket-name}:{path}

Disable Caching

By default the module will search the directories defined in 'Variant art search paths' only when the world is loaded or when the module settings have changed. If new art is added while the world is still open it will not be found by the module. 'Disable Caching' will force the search to be performed every time a new actor is created at a significant cost to speed at which the art is displayed to the user.


Filter by Monster (SRD)

Can be disabled if you want variant art to be retrieved for actors with names not found in Monster (SRD) list.


Search by Keyword

When enabled the art search will be done using both the Actor/Token full name as well as individual words within the name:

"Keyword Search"

Excluded Keywords

Words within this list will be excluded from the keywords search:

"Excluded Keywords"


Actor Directory Popup key

Controls the key used to trigger a popup when dragging an actor from the Actor Directory.


Display separate pop-ups for Portrait and Token art

When enabled the Art Select pop-up will be shown twice upon actor/token creation. Once for the portrait, and then again for the token art.


Portrait art filter

The string entered here will be used to filter the art shown in the portrait Art Select window.

For example if you wish the module to only pick up on files containing some sort of identifier in their name e.g. Dragon[Portrait].png and Smith[Portrait].jpg; by entering "[Portrait]" here only these images will be displayed in the pop-up.


Token art filter

Same as 'Portrait art filter', but is instead used when Art Select pop-up is opened to select token art.

Notify of
Inline Feedbacks
View all comments
Would love your thoughts, please comment.x