Entity

An Entity is a structured record about something in your fiction: a character, a location, a faction, an item, a piece of lore. Entities always live in a Codex — every Manuscript has one, so there’s nowhere else they could go missing.

Shape

Each Entity is a single file: YAML frontmatter for structured fields, free-form Markdown for the body.

entities/character/tomas.md
entities/location/bridgepoint.md

The frontmatter carries the structured bits (name, type, custom fields). The body is the long-form description — a character bio, a location’s history.

Entity Types

An Entity Type is the category — character, location, faction, item, plus any custom types you add. Types control the icon, colour, and the optional Entity Template that lays out fields for new Entities of that Type.

Inline references

Type [[ in any Scene, Tome Note, or Entity body to insert a reference. Trove autocompletes from the linked Codex and beyond.

References are rename-safe — they follow the record, not its title, so renaming a character doesn’t break a single link. Open an Entity and its References panel shows every Scene and note that mentions it. See References for how the whole graph works.

Beyond fields

• Relationships — typed links between two Entities (“sister of”, “sworn to”), drawn on the Relationship Map.
• Appearances — the Scene × Entity grid showing where each Entity is on the page: see Appearances.
• Maps — pin Entities to an image map: see Maps.

See also: Codex, the in-app Entity browser.