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

# Chart Cards

> Area, bar, line, and pie charts with breakdowns and mixed bar/line marks

Charts (area, bar, line, pie) let you pick one or more metrics and a dimension to group by. Bar and line charts support a per-metric **chart role** badge that toggles how that metric is drawn — as a **Bar** or a **Line** — letting you mix bar and line marks in the same chart.

The **Chart Display** section in the properties panel lets you select the chart type and, where applicable, a **Variant** (e.g. stacked for bar and area charts). Both options are grouped in one place.

## Breakdown

Area, bar, and line charts support a **Breakdown** dimension. When set, the chart splits the selected metric into separate series — one per unique value of the breakdown dimension.

Configure breakdown in the card's properties panel:

| Setting        | Description                                                                |
| -------------- | -------------------------------------------------------------------------- |
| **Breakdown**  | The dimension used to split the metric into series (e.g. Store, Territory) |
| **Sort**       | Whether to show series ranked highest-first or lowest-first by total value |
| **Max series** | Number of top series to display (5, 10, 15, 20, or 25)                     |

<Note>
  When a breakdown is active, only one metric can be selected — the metric picker is limited to a single selection.
</Note>