> ## Documentation Index
> Fetch the complete documentation index at: https://runway-docs.cfo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Charts block

> Chart blocks visualize drivers on pages so teams can spot trends, compare scenarios, and explain model movement.

Chart blocks bring driver values onto a page as visual reporting. Use them when a table has the right data, but a chart will make the trend, comparison, or variance easier to scan.

## Creating a chart block

<Steps>
  <Step title="Open block options">
    On a page, type **/** to access block options.
  </Step>

  <Step title="Choose Driver charts">
    Select **Driver charts**.
  </Step>

  <Step title="Choose drivers">
    Choose the drivers you want to visualize. You can add or remove drivers later.
  </Step>

  <Step title="Adjust the chart">
    New driver charts default to line charts. Use **Customize chart** to change chart type, combine drivers, adjust size, and configure labels.
  </Step>
</Steps>

## Chart types

The quick picker row shows **Line**, **Column**, **Stacked column**, **Combo**, **Value**, and **More**. The full picker includes the chart types below.

### Line

Use a line chart for trends over time.

### Column

Use a column chart for period-by-period values.

### Stacked column

Use a stacked column chart to show how multiple drivers contribute to a total.

### 100% stacked column

Use a 100% stacked column chart to compare percentage mix over time.

### Area

Use an area chart for trend magnitude when the filled area helps the story.

### Stacked area

Use a stacked area chart for cumulative trends with multiple contributors.

### 100% stacked area

Use a 100% stacked area chart to show changing percentage mix over time.

### Combo

Use a combo chart when different drivers need different visual treatments in one chart.

### Value

Use a Value chart for a compact selected-period KPI.

### Pie

Use a pie chart for a simple composition at one point in time.

### Donut

Use a donut chart for a compact composition chart.

### Nightingale

Use a Nightingale chart for radial comparisons where category magnitude matters.

### Waterfall

Use a waterfall chart to explain how a starting value moves to an ending value.

<Frame>
  <img src="https://mintcdn.com/runway-5055a12e/QgAyEmvdZUWT1iiY/images/pages/charts/types.png?fit=max&auto=format&n=QgAyEmvdZUWT1iiY&q=85&s=1daa610187e61d603b89fbbba09f30ae" alt="Chart type picker showing available chart options" width="1562" height="1182" data-path="images/pages/charts/types.png" />
</Frame>

## General chart customizations

### Combine charts

By default, each driver is displayed separately. Combine multiple drivers into a single chart when a consolidated view is easier to read.

<Frame>
  <img src="https://mintcdn.com/runway-5055a12e/QgAyEmvdZUWT1iiY/images/pages/charts/combine-drivers.png?fit=max&auto=format&n=QgAyEmvdZUWT1iiY&q=85&s=63c0867426e7aee854f0252ced905e37" alt="Chart customization showing combined drivers" width="3104" height="1868" data-path="images/pages/charts/combine-drivers.png" />
</Frame>

### Chart size

You can choose from three chart block sizes: **Small**, **Medium**, and **Large**.

* **Small** works well for compact **Value** charts.
* **Large** works well for detailed charts such as combo or stacked column charts.

<Frame>
  <img src="https://mintcdn.com/runway-5055a12e/QgAyEmvdZUWT1iiY/images/pages/charts/chart-size.png?fit=max&auto=format&n=QgAyEmvdZUWT1iiY&q=85&s=20c62edd127de98b5ae4d2f552043813" alt="Chart size menu with small, medium, and large options" width="2764" height="1858" data-path="images/pages/charts/chart-size.png" />
</Frame>

### Data labels

Turn on **Data labels** when labels should always be visible instead of appearing only on hover. You can adjust font size, weight, and color under **Advanced settings** > **Label settings**.

<Frame>
  <img src="https://mintcdn.com/runway-5055a12e/QgAyEmvdZUWT1iiY/images/pages/charts/data-labels.png?fit=max&auto=format&n=QgAyEmvdZUWT1iiY&q=85&s=3b5d5781918c5520b897eedf08231472" alt="Chart with data labels enabled" width="2766" height="966" data-path="images/pages/charts/data-labels.png" />
</Frame>

### Legend

The legend is hidden by default. You can show it on the right, left, top, or bottom of the chart. The legend is interactive, so clicking a driver toggles its visibility.

<Frame>
  <img src="https://mintcdn.com/runway-5055a12e/QgAyEmvdZUWT1iiY/images/pages/charts/legend.png?fit=max&auto=format&n=QgAyEmvdZUWT1iiY&q=85&s=ad9df2844b46611c72594e2c0ce1f19e" alt="Chart legend settings" width="1572" height="1086" data-path="images/pages/charts/legend.png" />
</Frame>

### Driver-level customizations

Click **Customize chart** and scroll to the driver list to customize each driver.

* **Change driver color:** Use a default color or choose a custom color.
* **Reuse custom colors:** Your 10 most recent custom colors are available across charts.
* **Switch the driver's axis:** Move a driver from the left Y-axis to the right Y-axis.
* **Change the driver's chart type:** Changing an individual driver type turns the chart into a combo chart.
* **Add or remove drivers:** Use search to add drivers, or use a driver's menu to remove it or open it in details.

<Frame>
  <img src="https://mintcdn.com/runway-5055a12e/QgAyEmvdZUWT1iiY/images/pages/charts/driver-config.png?fit=max&auto=format&n=QgAyEmvdZUWT1iiY&q=85&s=43800045bb124a2206be1c7e5ffc3c25" alt="Driver-level chart configuration panel" width="1850" height="1136" data-path="images/pages/charts/driver-config.png" />
</Frame>

<Note>
  Waterfall charts use different per-driver customizations because they explain movement from a beginning value to an ending value.
</Note>

### Axis settings

In **Advanced settings** > **Axis settings**, you can:

* Move the X-axis from bottom to top.
* Show or hide a solid line for each axis.
* Show or hide axis ticks.
* Add a title to each axis.

<Frame>
  <img src="https://mintcdn.com/runway-5055a12e/QgAyEmvdZUWT1iiY/images/pages/charts/axis-settings.png?fit=max&auto=format&n=QgAyEmvdZUWT1iiY&q=85&s=a13c8bc9a1e8e4ffa38297936ae7e055" alt="Axis settings panel for a chart block" width="1574" height="1120" data-path="images/pages/charts/axis-settings.png" />
</Frame>

### Date range

Every block on a page inherits the page-level date range by default. Override the date range at the chart level when a specific chart needs a different window.

<Frame>
  <img src="https://mintcdn.com/runway-5055a12e/QgAyEmvdZUWT1iiY/images/pages/charts/date-range.png?fit=max&auto=format&n=QgAyEmvdZUWT1iiY&q=85&s=c4e3bdf22b34fcf9a66e400889bd3fad" alt="Chart date range settings" width="3096" height="1118" data-path="images/pages/charts/date-range.png" />
</Frame>

### Rollups

You can add quarterly and annual rollups to time series charts.

<Steps>
  <Step title="Open Customize chart">
    Click **Customize chart** on the chart block.
  </Step>

  <Step title="Open Rollups">
    Select **Rollups**.
  </Step>

  <Step title="Choose rollups">
    Choose **Quarterly**, **Annual**, or both.
  </Step>
</Steps>

Rollup values appear alongside monthly data so you can see trends at different time granularities.

<Note>
  Rollups work on time series charts such as line, column, area, and combo charts. They are not available for non-time series chart types like Value or Waterfall.
</Note>

## Waterfall chart customizations

Waterfall charts show how a key metric moves from a starting value to an ending value by breaking out positive and negative contributions.

* By default, the waterfall chart respects the sign of each driver. To flip an expense or another driver where lower is better, enable **Lower is better**.
* To pull the leftmost column from the end of the previous period, enable **Use as beginning value** for that driver.
* Floating bars represent how other drivers affect the starting value across the selected time range.
* Waterfall charts include settings for **Totals**, **Omit zeros**, and colors for positive, negative, and total values.

<Frame>
  <img src="https://mintcdn.com/runway-5055a12e/QgAyEmvdZUWT1iiY/images/pages/charts/waterfall.png?fit=max&auto=format&n=QgAyEmvdZUWT1iiY&q=85&s=32514d6d940e0fd86e8752713cd9c390" alt="Waterfall chart customization options" width="5561" height="3952" data-path="images/pages/charts/waterfall.png" />
</Frame>

## Scenario comparison on charts

Line and column charts can compare the same drivers across scenarios.

<Steps>
  <Step title="Open Compare">
    Click the **Compare** button on the chart block.
  </Step>

  <Step title="Choose scenarios">
    Select the scenarios you want to compare.

    <Frame>
      <img src="https://mintcdn.com/runway-5055a12e/QgAyEmvdZUWT1iiY/images/pages/charts/scenarios.gif?s=31d3ed41a5dc05d74eba6882feea4689" alt="Chart comparing a driver across scenarios" width="800" height="499" data-path="images/pages/charts/scenarios.gif" />
    </Frame>
  </Step>
</Steps>

## Exporting charts

You can export a chart block in two ways:

* Use the block menu and select **Export to CSV** to export the data.
* Right-click the chart and select **Download** to download the chart image.

<Frame>
  <img src="https://mintcdn.com/runway-5055a12e/QgAyEmvdZUWT1iiY/images/pages/charts/export-chart.png?fit=max&auto=format&n=QgAyEmvdZUWT1iiY&q=85&s=ba82241e0128c25ecffc649af743413f" alt="Chart export menu" width="3147" height="972" data-path="images/pages/charts/export-chart.png" />
</Frame>

## Charts FAQ

<Accordion title="Can I view chart data by quarters or years instead of just months?" defaultOpen="false">
  Yes. Add quarterly and annual rollups to time series charts from **Customize chart** > **Rollups**.
</Accordion>

<Accordion title="Can Waterfall charts break the selected range into quarters?" defaultOpen="false">
  Waterfall charts display the selected time range as a single period. To compare quarters or years, create separate waterfall charts for each period.
</Accordion>

## What's next

* [Drivers table block](/concepts/pages/drivers-table-block)
* [Scenarios](/concepts/scenarios)
* [Exporting CSV](/integrations/exporting-csv)
