Skip to main content

Waterfall Component

The Waterfall component renders a bridge chart where bars float up or down from the previous bar's end value, making it ideal for decomposing variance, visualising how a starting value reaches an ending value through a series of positive and negative contributions. Common uses include budget-to-actual bridge, cash flow change narrative, and earned value variance breakdown.

Report Forge waterfall chart

Presets

PresetDescription
Budget to ActualOpens with Budget, closes with Actual. Intermediate bars show cost element variances.
Cash Flow BridgeOpening balance, cash inflows and outflows, closing balance.
EV VarianceBAC opening, CV and SV as steps, EAC as closing bar.
Cost BreakdownOpening total, one bar per cost category, closing total.
Change LogOpening approved budget, approved changes as steps, current budget as closing bar.

Data binding

PropertyDescription
Label fieldThe name of each step shown on the X axis.
Value fieldThe numeric increment or decrement at each step. Positive values raise the bar; negative values lower it.
Step type fieldOptional field indicating whether a step is a regular increment or a subtotal anchor.
Sort orderThe order in which steps are displayed. Can be by a sort field or by value magnitude.

Bar types

TypeDescription
IncrementA floating bar showing a positive change (default). Colored with the positive color.
DecrementA floating bar showing a negative change. Colored with the negative color.
SubtotalA bar anchored to zero showing a running total at that point. Distinct color from increment/decrement.
OpeningThe first bar, anchored to zero. Represents the starting value.
ClosingThe final bar, anchored to zero. Represents the ending value.

Configure step type either through a data field or by explicitly assigning type per row in the component's step editor.


Appearance options

OptionDescription
Positive colorFill color for increment bars. Default: green.
Negative colorFill color for decrement bars. Default: red.
Subtotal colorFill color for subtotal and opening/closing bars. Default: dark gray or blue.
Connector linesLines connecting the top of each bar to the base of the next. Toggle on/off.
Data labelsShow the value on each bar. Position: inside top, outside top, or auto.
Bar widthFraction of the category width (0.3 to 0.9).

Others grouping

When there are many small steps that individually contribute little, enable Others grouping to collapse them:

  1. In Properties → Others, enable grouping.
  2. Set the threshold: steps whose absolute value is below the threshold percentage of the total are merged into a single "Others" bar.
  3. Configure the "Others" label text.

Good practice

  • Keep the number of steps to ≤ 12 for readability. For longer lists, group smaller items using Others grouping.
  • Always include an Opening and a Closing bar so the chart is self-explanatory.
  • When a subtotal bar appears mid-chart, label it clearly (e.g., "Sub-total to Q2").
  • Use data labels on all bars so the chart doubles as a data table for readers who print the report.