Skip to content

Journey

Stages left to right, optionally in parallel lanes.

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 render

Onboarding

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
SettingTypeRequiredDefaultMeaning
titlestringno—Journey title shown above the diagram.
dirhorizontal · verticalnohorizontalhorizontal 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 patch

Support request

Customer

Report

Hits a bug

Wait

Checks email

Support

Triage

Reads the ticket

Fix

Ships patch