User journeys in Confluence

A user journey lists the steps a person takes to reach a goal and scores how each step feels.

Last updated

When to use it

Use a user journey in product and UX work: the first week of a new user, a first purchase, a support request. Each step has a score from 1 to 5 and the people involved, so the low points of the experience stand out.

Example

This is the code of the First week template: a new user from sign-up to the upgrade decision.

journey
  title First week with the product
  section Day 1
    Sign up: 4: User
    Invite the team: 3: User, Admin
  section Day 2 to 4
    Create first diagram: 5: User
    Share with the team: 4: User
  section Day 5
    Review feedback: 3: User, Team
    Decide to upgrade: 4: Admin

Vellnar Diagrams draws it like this:

Change a line and the diagram changes with it. Nobody needs the original drawing file, because there is none: the code is the diagram.

Add it to a Confluence page

  1. Edit a Confluence page and type /mermaid where the diagram should go.
  2. Select Mermaid diagram. The editor opens with the template list.
  3. Pick a template, or choose Start blank and paste the code above. The preview follows every keystroke.
  4. Choose Save. The diagram appears on the page.

The documentation covers the editor, the settings and the exports.

Templates

The Templates button in the editor has 2 user journeys ready to use:

  • First purchase: How a customer discovers, decides and buys.
  • First week: A new user from sign-up to the upgrade decision.

Syntax

The code of a user journey starts with journey. The Mermaid documentation describes every element of the syntax. Vellnar Diagrams draws it with Mermaid 12.3; if a line has an error, the editor marks the line and keeps the last valid diagram on screen.

More

  • Mermaid in Confluence: how diagrams as code work in a page, and every diagram type.
  • Security: the app asks for no permissions and sends nothing outside Atlassian.