Portrait Vault

⚔️ Weaver+ Weaver and above

The Portrait Vault is a per-world image library for NPC portraits. Upload portraits once, tag them, and assign them to any NPC entity from the portrait picker without re-uploading.

Adding portraits to the vault

From the vault page:

  1. Open your world and click Portrait Vault in the sidebar.
  2. Click + Upload Portrait.
  3. Select one or more image files.
  4. Add tags on the upload screen (or tag later).
  5. Click Save.

From the entity editor:

When editing an NPC entity, open the portrait picker and click Upload to Vault. The image is added to the vault and assigned to the entity in one step.

Tagging portraits

Tags let you filter the vault when searching for a portrait that fits a character. Four tag dimensions are available:

Species (19 options)

Human · Elf · Half-Elf · Dwarf · Gnome · Halfling · Half-Orc · Tiefling · Dragonborn · Aasimar · Genasi · Tabaxi · Tortle · Kenku · Lizardfolk · Warforged · Firbolg · Goliath · Other

Gender (4 options)

Male · Female · Non-binary · Androgynous

Archetype (18 options)

Warrior · Mage · Rogue · Cleric · Ranger · Paladin · Bard · Druid · Monk · Warlock · Artificer · Merchant · Noble · Scholar · Guard · Villager · Criminal · Other

Style tags (freeform)

Add any descriptive terms: scarred, hooded, elderly, masked, tattooed, armored, robed, veteran, etc. Multiple freeform tags per portrait are supported.

💡Tip

Style tags are the most useful filter during session play when you need a portrait fast. Tag portraits with physical descriptors like bald, bearded, young, or blind so you can find the right face in seconds.

Browsing and filtering the vault

On the Portrait Vault page, use the filter panel on the left to narrow results:

  • Select one or more species
  • Select one or more genders
  • Select one or more archetypes
  • Type style tags to filter (partial matches work)

Filters combine with AND logic — selecting Elf + Warrior + scarred returns only portraits tagged with all three. Clear individual filters with the X on each tag chip.

Assigning a portrait to an NPC

  1. Open the NPC entity you want to assign a portrait to.
  2. Click the portrait placeholder (circular avatar at the top of the entity) or click Edit Portrait in the metadata panel.
  3. The portrait picker opens. Click Browse Vault.
  4. Filter and select a portrait from the vault.
  5. Click Apply.

You can also upload a new image directly from the picker without going through the vault page — it is added to the vault automatically.

Portrait display

Assigned portraits appear:

  • As a circular avatar on the entity page header
  • In the entity browser sidebar (beside the NPC name)
  • On NPC tokens placed on maps (if the token icon is set to portrait)
  • In the player portal on party-visible NPCs
📝Note

Portrait Vault storage is per world, not per account. Portraits uploaded to World A are not available in World B. If you use the same portrait in multiple worlds, upload it to each world's vault separately.