Sankey diagrams in Confluence

A Sankey diagram shows how a quantity flows from sources to destinations; the width of each band is the amount.

Last updated

When to use it

Use a Sankey diagram when you need to see where a total goes: visitors through a funnel, tickets through support tiers, budget through teams. You write one line for each flow (source, target, value) and the largest losses become the widest bands.

Example

This is the code of the Activation funnel template: where visitors drop off between visit, sign-up, onboarding and paying.

sankey-beta

  Visits,Bounced,7000
  Visits,Signed up,3000

  Signed up,Onboarding completed,1800
  Signed up,Dropped during onboarding,1200

  Onboarding completed,Paying,450
  Onboarding completed,Free plan,1350

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 Sankey diagrams ready to use:

  • Activation funnel: Where visitors drop off between visit, sign-up, onboarding and paying.
  • Ticket routing: Support tickets from each channel through triage, tiers and engineering.

Syntax

The code of a Sankey diagram starts with sankey-beta. 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.