> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/mermaid-js/mermaid/llms.txt
> Use this file to discover all available pages before exploring further.

# User journey diagrams

> Visualize user workflows and experiences with user journey diagrams in Mermaid.

User journey diagrams describe at a high level of detail the exact steps different users take to complete a specific task within a system, application, or website. This technique shows the current (as-is) user workflow and reveals areas of improvement for the to-be workflow.

## Basic example

```mermaid theme={null}
journey
    title My working day
    section Go to work
      Make tea: 5: Me
      Go upstairs: 3: Me
      Do work: 1: Me, Cat
    section Go home
      Go downstairs: 5: Me
      Sit down: 5: Me
```

## Syntax overview

Each user journey is split into sections that describe the part of the task the user is trying to complete.

### Basic structure

```
journey
    title [Title text]
    section [Section name]
      [Task name]: [Score]: [Actors]
```

### Task syntax

Tasks follow this format:

```
Task name: <score>: <comma separated list of actors>
```

The score is a number between 1 and 5 (inclusive), representing the user's satisfaction or experience level with that task.

## Complete example

Here's a more detailed user journey showing a typical working day:

```mermaid theme={null}
journey
    title My working day
    section Go to work
      Make tea: 5: Me
      Go upstairs: 3: Me
      Do work: 1: Me, Cat
    section Go home
      Go downstairs: 5: Me
      Sit down: 5: Me
```

## Multiple actors

Tasks can involve multiple actors by separating them with commas:

```mermaid theme={null}
journey
    title Team collaboration
    section Planning
      Review requirements: 4: Dev, Designer
      Create wireframes: 5: Designer
      Technical planning: 3: Dev, Architect
    section Development
      Write code: 2: Dev
      Design review: 4: Dev, Designer
      Testing: 3: Dev, QA
```

## Scoring guide

The score represents the user's experience:

* **5** - Very positive experience
* **4** - Positive experience
* **3** - Neutral experience
* **2** - Negative experience
* **1** - Very negative experience

<Tip>
  Use user journey diagrams to identify pain points in user workflows. Tasks with low scores (1-2) often indicate areas that need improvement.
</Tip>

<Note>
  User journey diagrams are excellent for stakeholder presentations as they clearly show the user's emotional experience throughout a process.
</Note>