Story Builder documentation

Relations graph

The relations graph draws your world as a web of connections: records as dots, relations as the lines between them. Use it as a character relationship map, to see who has drifted to the edge of the story, or to find how two records are connected.

Where do I find the graph? #

In four places, each with its own settings:

Graph Where What it shows
Project graph Graph in the project's sidebar Every record and relation. The only one where you can edit connections and show unconnected records
Characters graph Graph view at the top of the Characters list Characters only, starting on the Cast preset
A record's graph The list and graph switch on the Related entries card of any record's page The record and what it is linked to; clicking a dot opens that record
Dashboard graph The Relation graph card on the dashboard A small graph that becomes the full one when you expand the card

The graph on record pages can be switched off with Relation graphs on pages, under the Graph module in Settings → Modules (see modules).

Reading the graph #

Each record type has its own colour and shape: a character is a circle, a location a diamond, a creature a triangle, an organization a hexagon, an event a star. A few types share a shape and differ by colour, such as a place and a book (squares). Records of a collection take the collection's colour. When two records share a name, the label adds the type: Haven · Character, Haven · Location.

  • Filter types beside the search box opens the type chips: how many records of each type the graph holds. Click a chip to hide or show that type; the button counts the types you have hidden.
  • Busy records are drawn larger and named first; quieter ones get their names as you zoom in.
  • Hover over a record to light up its connections. With Dim unrelated records on, the rest fade.
  • Fit to view (or F) brings the whole graph back on screen.
  • On the project graph, turn on Show unconnected records in the settings to add records nobody has linked yet. They gather in a ring around the graph.
  • On a phone the tools fold into the ⋮ menu, and a record's panel and the settings open from the bottom of the screen.

Presets and advanced settings #

Graph settings (the sliders icon) start on Presets, each a ready-made way of looking at the world; hover one to see what it is for:

  • Overview: every record as a point, the busiest named first;
  • Clusters: linked records pulled together, so groups stand apart;
  • Cast: characters, creatures and organizations, with their roles;
  • Places and events: locations, places, maps and events only;
  • Dense, for very large projects: small points, only records with two or more links;
  • Presentation: named boxes, roles on links and plenty of room.

Graph type switches between 2D and 3D. In 3D you can find, select and turn the graph, but not edit connections or click a line.

Switch to Advanced to change how records are drawn (Points or Labels), when labels appear, Show roles on links, Dim unrelated records, sizes and line thickness, Minimum links (how many links a record needs to appear) and the forces that lay the graph out. Once you change something, the preset shows as Custom, from Overview (or whichever it started from), and Reset to Overview puts it back. Each of the four graphs remembers its own settings, for you only: collaborators keep theirs.

How do I find a record on a big graph? #

Type its name, or any of its other names, into Find a record at the top of the graph. Results show the name and the type, and picking one centres the graph on it, zooms in and selects it. A record hidden by Filter types or Minimum links is shown anyway, and a message says when the minimum was lowered to show it. Find works in 3D too.

Selecting a record opens its panel: its connections grouped by type, busiest first, with each connection's role. Choose 1, 2 or 3 steps to see who is connected to its connections. Click a name to move to that record; Open goes to its page, and Quick look previews it without leaving the graph.

  • Isolate its neighbourhood hides everything more than the chosen number of steps away. More steps and Fewer steps in the bar above the graph, or + and −, widen or narrow it; Show everything or Esc shows the rest again.
  • Find a path answers "how are these two connected?". Pick two records, or start from a selected one with Find a path from here, and the graph highlights the shortest chain between them and spells it out: Ana — mentor of → Bram — member of → the Silver Order. The search covers the whole project, not only what is drawn.

Modes: path, focus and editing #

Finding a path, focusing on a neighbourhood and editing connections are modes. While one is on, a bar across the top of the graph names it and says what to do next ("Pick the first record"), the graph gets a coloured frame, and the toolbar button stays lit. Done or Esc leaves the mode. Path and editing never run together: starting one ends the other. Keyboard shortcuts, under the info icon in the settings, lists the keys, such as P for a path and E for editing.

How do I connect records on the graph? #

On the project graph, turn on Edit connections (or press E), then drag from one record to another. A small window asks for the role each plays — for two characters, the same relation types as on a character's page — and an optional note, and Connect adds the relation. You can also click, or on a phone tap, one record and then the other.

  • Drag from a record into empty space to create a new record, already linked to the first.
  • Click a line to see the Connection: both records, their roles and the note. While editing, the same panel has Save roles and Remove connection.
  • Edit connections appears only for people with the Manage Relations permission, and not in 3D.

Does the graph follow the as-of date? #

Yes. While you view the world as of a date, the graph hides relations to records that did not exist yet or any more on that date, and memberships outside their dates. Show unconnected records and Find a path still look at the whole project.

How does a large project load? #

In pages. The graph opens with the first 1,500 relations and fetches the rest in the background, a few hundred at a time; while that goes on, a progress bar in the toolbar counts the relations loaded, and the graph fills in without moving what is already drawn. If a page cannot be loaded, the warning icon in the toolbar says so and Try again beside it resumes where it stopped.

Past 6,000 relations the graph stops loading, and the warning icon says how many of how many are shown. Whatever is drawn, selecting a record loads its relations, and Find a path searches the whole project; if a search reaches its limit it says so, instead of reporting that nothing connects. Find looks among the records drawn, so wait for the progress bar to finish when a record you expect is missing.

Tips #

  • Open the graph after a big writing session to see who has drifted to the edge of the story, or switch on Show unconnected records to see who was never linked at all.
  • Plan with the graph open: drag a new character out of the city they live in, and the relation is made in the same move.
  • Use Cast for the people of the story and Places and events for the shape of the world; it is easier to read two focused graphs than one crowded one.
  • Find a path between two characters who never meet on the page often turns up the subplot that links them.