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
- Edit a Confluence page and type
/mermaidwhere the diagram should go. - Select Mermaid diagram. The editor opens with the template list.
- Pick a template, or choose Start blank and paste the code above. The preview follows every keystroke.
- 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.