# Revenue bridge (waterfall chart)

> What moved MRR from December to November: new business and upsell added, downsell and churn taken off, as steps.

This chart is one Chart-Output API request. Send the request below to `POST https://www.chart-output.com/api/v1/render` with an `Authorization: Bearer <API key>` header and the response is the image. The free plan includes 1,000 renders a month, no card.

- Page: https://www.chart-output.com/gallery/revenue-bridge
- Request as JSON: https://www.chart-output.com/gallery/revenue-bridge/spec.json
- Get a free API key: https://www.chart-output.com/auth/sign-up?ref=gallery-revenue-bridge-md

## When to pick it

Use it when someone asks "why did the number change?" and you want the drivers as steps from the start to the end.

## The data it takes

Columns: Step, Change. 2 to 10 rows. The first row is the starting total and each row after it is a change (a minus for a fall). The end total is worked out for you. In $ thousands, or in dollars.

## The request

Change the content (title, labels, numbers, KPI values, annotations) and keep the rest.

```json
{
  "type": "bar",
  "width": 560,
  "height": 640,
  "textScale": 1.8,
  "format": "png",
  "devicePixelRatio": 2,
  "dataLabels": true,
  "data": {
    "labels": ["Dec", "New", "Upsell", "Downsell", "Churn", "Nov"],
    "datasets": [
      {
        "grouped": false,
        "borderWidth": 0,
        "borderRadius": 3,
        "barPercentage": 0.74,
        "categoryPercentage": 0.92,
        "label": "Total",
        "data": [
          [0, 52.4],
          null,
          null,
          null,
          null,
          [0, 84.19999999999999]
        ],
        "backgroundColor": "#1d2640",
        "datalabels": {
          "offset": 4,
          "clamp": true,
          "color": "#1d2640",
          "font": {
            "size": 18,
            "weight": "700"
          },
          "numberFormat": {
            "maximumFractionDigits": 1
          },
          "anchor": "end",
          "align": "end"
        }
      },
      {
        "grouped": false,
        "borderWidth": 0,
        "borderRadius": 3,
        "barPercentage": 0.74,
        "categoryPercentage": 0.92,
        "label": "Change",
        "data": [
          null,
          [52.4, 76.5],
          [76.5, 89.7],
          [89.7, 86.5],
          [86.5, 84.2],
          null
        ],
        "backgroundColor": ["#3c5cdd", "#3c5cdd", "#3c5cdd", "#e0602a", "#e0602a", "#3c5cdd"],
        "datalabels": {
          "offset": 4,
          "clamp": true,
          "color": "#1d2640",
          "font": {
            "size": 18,
            "weight": "700"
          },
          "numberFormat": {
            "maximumFractionDigits": 1,
            "signed": true
          },
          "anchor": ["end", "end", "end", "start", "start", "end"],
          "align": ["end", "end", "end", "start", "start", "end"]
        }
      }
    ]
  },
  "options": {
    "indexAxis": "y",
    "plugins": {
      "legend": {
        "display": false
      },
      "tooltip": {
        "enabled": false
      }
    },
    "scales": {
      "x": {
        "display": false,
        "beginAtZero": true,
        "grid": {
          "display": false
        },
        "grace": "26%"
      },
      "y": {
        "grid": {
          "display": false
        },
        "border": {
          "display": false
        },
        "ticks": {
          "color": "#1d2640",
          "font": {
            "weight": "600"
          }
        }
      }
    }
  },
  "kpiStrip": [
    {
      "label": "Dec MRR",
      "value": "$52.4k",
      "color": "#1d2640"
    },
    {
      "label": "Nov MRR",
      "value": "$84.2k",
      "color": "#1d2640"
    },
    {
      "label": "Change",
      "value": "+60.7%",
      "color": "#13703f"
    }
  ],
  "footer": {
    "left": "Source: billing",
    "borderTop": true
  },
  "header": {
    "title": "What moved MRR",
    "subtitle": "Dec 2025 to Nov 2026, $ thousands",
    "logoUrl": "https://www.chart-output.com/gallery/acme-logo.png",
    "logoHeight": 22
  },
  "theme": {
    "backgroundColor": "#ffffff",
    "textPrimary": "#1d2640",
    "textSecondary": "#4a5368",
    "gridColor": "#e3e7ef",
    "mode": "light"
  }
}
```

## Questions

### How do I make this revenue bridge chart with my own data?

Paste your numbers into the box on this page and the chart and its request update. To make it from your own workflow, send that request to POST https://www.chart-output.com/api/v1/render with a free API key; the response is the image.

### What data does it take?

Columns: Step, Change. 2 to 10 rows. The first row is the starting total and each row after it is a change (a minus for a fall). The end total is worked out for you. In $ thousands, or in dollars.

### Can ChatGPT or Claude make this chart?

Yes. Add https://www.chart-output.com/mcp as a custom connector and ask for the chart; its render_chart tool takes this page's request and returns the image, with no API key. Or use "Copy prompt for your AI" on this page.

### What does it cost?

The free plan includes 1,000 renders a month, with no card. Paid plans add more renders and remove the watermark.

### What do I get back?

A finished image: PNG by default, or SVG, WebP or JPEG, and PDF on Pro. Set "format" in the request.
