Waterfall

Use it to explain a change: opening balance, what came in, what went out, closing balance. Totals stand on the baseline; changes float and connect with a dashed rule.

← All charts

Live demo

Made-up data. Try the options, then switch to the empty and one-point states.

Hover a bar for its amount. Labels alternate in height on narrow screens so they do not collide.

How to use it

Paste the toolkit from Get the code into your page first, then call the chart like this.

JavaScript
const chart = waterfall({
  steps: [
    { label: 'Start',     value: 4200, total: true },
    { label: 'Salary',    value: 3100 },
    { label: 'Housing',   value: -1210 },
    { label: 'Groceries', value: -438 },
    { label: 'End',       value: 5652, total: true }
  ],
  height: 300,
  label: 'How the balance changed in September'
});

Options

What you can pass to this chart.

steps

[{ label, value, total?, colour? }]. value > 0 adds, value < 0 subtracts; total: true restarts from zero at that value.

height

Chart height.

label

aria-label.

Want charts or dashboards like these in your own product?

Tell me what you are trying to see and I can help work out the right approach, from the data behind it to the screen in front of people.