# Waterfall Chart

Renders a waterfall chart.

| <picture><source srcset="https://1875572357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzP7hFWzU2Jj7xMbv2nyp%2Fuploads%2Fgit-blob-6e2ad9e757753038a1c7da7d2f2c62ea3ed7bfe0%2Fwaterfall-waterfall-dark.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://1875572357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzP7hFWzU2Jj7xMbv2nyp%2Fuploads%2Fgit-blob-467b3616d9775341f85aeb5c78b5dbf3574c115d%2Fwaterfall-waterfall-light.png?alt=media" alt="Waterfall"></picture> |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

## Specifications

### Aggregation

The waterfall chart [aggregates values (metrics) for each label (dimension)](https://docs.codatum.com/data-exploration/chart-common#dimension-metric) and displays them cumulatively.

| Item  | Role      | Notes                                               |
| ----- | --------- | --------------------------------------------------- |
| Label | Dimension | Item names for each bar in the waterfall            |
| Value | Metric    | Displayed as the increase or decrease for each item |

#### Example Configurations

* Display "Opening balance → Revenue → Costs → Other" as a waterfall (e.g., P\&L or cash flow breakdown)
  * Label (Dimension): Opening balance, Revenue, Costs, Other, Closing balance, etc.
  * Value (Metric): Amount (increase/decrease) for each item

## Tips

### Frame Feature

Waterfall charts support the frame feature. See [Frame Feature](https://docs.codatum.com/data-exploration/chart-common#frame-feature) for details.