A user journey diagram maps out the steps a person takes to complete a goal, together with how they feel at each stage. Steps are grouped into sections that represent phases of the experience. A score from 1 (frustrating) to 5 (delightful) shows the emotional tone of each step.
User journeys help writers, designers, and planners see an experience from the user's point of view — spotting friction points and moments of delight that might not be obvious from a task list alone.
journey
title Planning a Holiday to Italy
section Research
Browse destination ideas: 5: Traveller
Read travel blogs: 4: Traveller
Compare flight prices: 2: Traveller
section Booking
Book flights online: 4: Traveller
Reserve hotel: 4: Traveller
Buy travel insurance: 2: Traveller
The scores reveal where the journey feels smooth and where it drags — comparing flight prices and buying insurance score low, flagging them as candidates for improvement.
Syntax
MARKDOWN
```mermaid
journey
title Planning a Holiday to Italy
section Research
Browse destination ideas: 5: Traveller
Read travel blogs: 4: Traveller
Compare flight prices: 2: Traveller
section Booking
Book flights online: 4: Traveller
Reserve hotel: 4: Traveller
Buy travel insurance: 2: Traveller
```
For more user journey diagram syntax see the user journey diagram documentation at mermaid.js.org