Skip to content

Linking objects to entities

An entity is the canonical “Aldren”. Most of the time you encounter Aldren through one of his representations — the wiki article about him, his actor sheet, the node on the family-tree board, the pin on the capital. Linking (also called binding) ties those representations to the entity so they’re explicitly the same thing.

Any of these objects can be linked to an entity:

Surface What linking means
Wiki page This page is the article for this entity.
Actor sheet This actor plays this entity.
Board node This node stands for this entity.
World-map pin / path / region This shape represents this entity’s location.
Scene This scene depicts this entity (often a place).
Board This whole board describes this entity (e.g., a family-tree board for a House).
World This world is the entity. Rare — used when a world represents one canonical setting.

An entity can have many objects linked to it. Usually an object stands for one entity, but it can stand for several — see One sheet, several people.

Open the page, sheet, board or scene, then the Companion (⌥C, or Alt-C). Under the name on its focus card:

  • Linked — a pill names the entity, such as Is Aldren · person. Click it to look at the entity.
  • Not linked — Make this an entity sits there instead, on wiki pages, actors, cards, scenes, boards and worlds.

Once linked, ⋯ → Manage entity links… lists the entities it represents, each with an Unlink button. An actor’s page and your library’s details panel show the same list as an Entity section — see Actors vs entities.

Something can represent more than one entity, and character sheets usually do. A single Cultist sheet is the sheet for every cultist in your world — Brother Marek and Sister Vell play from the same stats and are different people.

So Manage entity links… shows a list, with Promote another to this actor to add the next one. Unlink removes just the one you picked. The pill on the focus card names the main one.

Rename an entity and the wiki page linked to it is renamed too — and the other way round. You never have to remember to change it twice, and the mention dropdown, the graph and your timeline all follow.

This applies to the page an entity is primarily about. A page that merely mentions several entities isn’t renamed by any of them.

Make this an entity creates a new entity and links the object to it in one step. The Promote to entity dialog asks for a type and a name (starting from the object’s title); click Promote. It always creates a new entity.

To link the object to an entity that already exists, choose Link to an entity… from the ⋯ menu instead and pick it — see Making connections from the Companion. A world-map shape points at an existing entity through its Linked entity field (below).

Entities always belong to a world, but actors and cards don’t — those live in your library. So when you promote an actor or card, the dialog adds a World picker: choose the world the entity should belong to and the binding completes. For scenes and boards, the dialog can also file the original into that world if it isn’t there yet.

Inside a wiki page editor, typing [[name brings up the mention dropdown. Entity hits appear alongside wiki pages and are tagged entity. Picking one inserts a link that doubles as a permanent mention edge — see Aliases & search for how aliased names work in the dropdown.

World-map tools (pin / path / region) have a dedicated Linked entity field in their tool panel.

Two ways:

  • From the linked side — open it, and in the Companion choose ⋯ → Manage entity links…, then Unlink.
  • From the entity — open its Connections tab, find the row for the object, and click its Unlink button.

Either way, the binding goes away; the object and the entity both remain.

The Connections tab — linked objects, board appearances and backlinks