Journey
Stages left to right, optionally in parallel lanes.
@journey
Section titled “@journey”A user journey. Stages run left to right, each written stage <name> with an optional feeling=happy|neutral|frustrated; touchpoints, actions and pain points go on indented lines under it. The feelings are drawn as a line above a neutral baseline, which is the point of the diagram — you can see where the experience falls over before reading a word. Use track for parallel swim lanes (frontstage / backstage, customer / support). Seven stages fit a portrait page; past that use dir=vertical.
A block written inside it is drawn below it. What goes inside what
@journey title="Onboarding"
stage Discover feeling=happy
Finds the landing page
Tries the playground
stage Install feeling=neutral
Copies the command
Waits for download
stage First doc feeling=happy
Opens welcome.jot
Edits and sees it renderOnboarding
Discover
Finds the landing page
Tries the playground
Install
Copies the command
Waits for download
First doc
Opens welcome.jot
Edits and sees it render
Settings
| Setting | Type | Required | Default | Meaning |
|---|---|---|---|---|
title | string | no | — | Journey title shown above the diagram. |
dir | horizontal · vertical | no | horizontal | horizontal draws stages across the page with the emotion line under their names. vertical runs down the page — no line, the feeling is carried by the mark beside each stage — and fits any number of stages. |
More examples
@journey title="Support request"
track Customer
stage Report feeling=frustrated
Hits a bug
stage Wait feeling=frustrated
Checks email
track Support
stage Triage feeling=neutral
Reads the ticket
stage Fix feeling=happy
Ships patchSupport request
Customer
Report
Hits a bug
Wait
Checks email
Support
Triage
Reads the ticket
Fix
Ships patch