StoryGraph · Node types
Twist
Twist is a Reveal with a kick — it discloses new information AND overturns something the reader believed, re-colouring everything that came before.


TwistNode type
A reveal that also flips what was believed.
Twist discloses a fact and, at the same time, nullifies a belief the reader was holding. Its two knowledge-layer fields are the point: what’s revealed, and which prior belief it overturns.
AffectsThe knowledge state AND the reader’s understanding — it recolours what came before.
Wire itUse it at the moment a truth lands that changes how earlier beats read. Set both what’s revealed and the belief it overturns.
Parameters
Reveals + Overturnstags
What’s disclosed, and which prior belief it nullifies.
AffectsUpdates the knowledge state and rewrites the reader’s model of the story so far.
Use-case variants
- Identity twist — someone is not who they seemed
- Reframe twist — the same facts, a new meaning
A twist that overturns a belief the reader never held falls flat — plant the belief first.
In the editor
