STATISTICS / CHART GUIDE

Waterfall Chart

A waterfall chart visualizes the incremental changes from a starting value to an ending result, clearly breaking down positive and negative contributions.

01 / EXPLORE

See it in action.

Switch to Code to copy an example.

About Waterfall Chart

A waterfall chart visualizes the incremental changes from a starting value to an ending result, clearly breaking down positive and negative contributions. By showing an initial value, multiple increases and decreases, and a final total, it helps analyze the impact of each step on the overall result. It is commonly used in financial statements, budget comparisons, and phased metric breakdowns.

02 / CONFIGURE

Make it yours.

The properties available for this chart.

Configuration Options

Property	Type	Required	Description
`type`	`string`	required	Value must be "waterfall".
`data`	`Object[]`	required	Chart data.
`data.category`	`string`	required	Step name or category name.
`data.value`	`number`	optional	Increase or decrease for the step (positive for increase, negative for decrease).
`data.isIntermediateTotal`	`boolean`	optional	Whether this is an intermediate total bar, default is false.
`data.isTotal`	`boolean`	optional	Whether this is a total bar, default is false.
`title`	`string`	optional	Chart title.
`axisXTitle`	`string`	optional	X-axis title.
`axisYTitle`	`string`	optional	Y-axis title.
`theme`	`BuiltinThemeName \| ThemeSpec`	optional	Built-in theme name or custom theme object; default is "default". See Documentation → Custom Themes.
`style`	`Object`	optional	Chart style.
`style.backgroundColor`	`string`	optional	Must be a valid color value.
`style.palette`	`string[]`	optional	Order is [positive color, negative color, total color], default is ["#FF4D4F", "#2EBB59", "#1783FF"].