Portrait Vault

👑 Runekeeper

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.

/help/screenshots/portrait-vault/01-vault-grid.png

The Portrait Vault grid showing uploaded portrait thumbnails with tag filters in the sidebar.

Capture: open Portrait Vault with 6+ portraits uploaded — screenshot the full grid with the tag filter panel visible and at least one tag active

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.

Troubleshooting

The Portrait Vault option isn't in my world sidebar. Portrait Vault requires Runekeeper tier. If you're on Weaver or Chronicler, the sidebar item doesn't appear. You can still assign portraits directly on entity pages (upload from the entity, bypassing the vault), but the vault library and tagging system requires Runekeeper.

I applied a portrait from the vault but it's not showing on the entity. After selecting a portrait and clicking Apply, the entity page should refresh the avatar immediately. If it's still showing a placeholder, try a hard refresh. If you're in a browser that aggressively caches images, clear the cache for the site.

My vault filter returned no results but I know there are matching portraits. Vault filters use AND logic — all selected filters must match a portrait to show it. If you've selected multiple species, archetypes, or style tags, try clearing some filters to widen the results. Style tag filtering uses partial matching, so beard matches bearded, but check for typos.

A portrait is assigned to an NPC but isn't showing on their map token. Map tokens use the portrait only if the token icon is set to Portrait (not one of the preset icons). Open the token's edit panel on the map and change the Icon setting to Portrait.

See also