Waterfall chart

Use a waterfall chart to show how category contributions build from one total to another.

Every preview on this page is generated from the YAML shown below it using a fixed documentation dataset.

Revenue bridge

Use signed business contributions so the bridge visibly distinguishes gains from losses and explains the net movement.

Key fields

visuals:
  revenue_bridge_waterfall:
    title: Revenue drivers
    description: Explains positive and negative contributions to net revenue growth.
    type: waterfall
    presentation:
      type: cartesian
      labels:
        density: automatic
        priority:
        - selected
        - anomaly
        - threshold
        maxCharacters: 18
        minimumSpacing: 6
        tooltipFallback: true
    query:
      type: aggregate
      dimensions:
      - component
      metrics:
      - revenue_impact
      sort:
      - field: component
        direction: asc

Alternate metric

Replace revenue with order count to reuse the same running-contribution structure for volume rather than value.

Key fields

visuals:
  orders_waterfall:
    title: Monthly order contribution
    type: waterfall
    query:
      type: aggregate
      dimensions:
      - purchase_month
      metrics:
      - order_count
      sort:
      - field: purchase_month
        direction: asc
      limit: 18
    presentation:
      type: cartesian

Labels and zoom

Use presentation.labels for exact contributions and dataZoom when many categories make the running sequence dense. Automatic collision handling keeps compact cards readable.

Key fields

visuals:
  revenue_waterfall_labeled:
    title: Labeled revenue waterfall
    type: waterfall
    presentation:
      type: cartesian
      labels:
        density: automatic
        priority:
        - selected
        - anomaly
        - threshold
        maxCharacters: 18
        minimumSpacing: 6
        tooltipFallback: true
      dataZoom: true
    query:
      type: aggregate
      dimensions:
      - category
      metrics:
      - revenue
      sort:
      - field: revenue
        direction: desc
      limit: 12

API reference

Kind: chart. Renderer: echarts. Supported result shapes: category_delta.

Field	Type	Default	Allowed values	Description
`query.dimensions`	`field mapping`	—	—	Groups query results and supplies category or hierarchy labels.
`query.limit`	`integer`	`no limit`	`positive integer`	Caps the number of rows returned to the renderer.
`query.metrics`	`metric mapping`	—	—	Selects governed semantic metrics consumed by the visual shape.
`query.sort`	`sort list`	—	—	Orders query results by a returned field or metric alias.
`presentation.dataZoom`	`boolean`	`false`	`true` `false`	Adds bounded zoom controls to supported Cartesian charts.
`presentation.labels`	`label policy`	`hidden`	`hidden` `automatic` `dense` `always`	Controls deterministic label density, priority, truncation, and tooltip fallback.

Accessibility. Use a descriptive title and unit, and do not rely on color alone to distinguish series or values.