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

# Configure a chart on a dashboard

> Set the chart type, filters, group-by, time frame, granularity, percentile, users, rating, and description for one chart on a dashboard.

Each chart on a [dashboard](https://www.plain.com/docs/product/platform/dashboards.md) has its own settings, so 2 copies of the same chart can show different slices of your threads. Those settings apply to one chart only. The dashboard's [time range](https://www.plain.com/docs/product/platform/dashboards/build-a-dashboard.md#set-the-dashboard’s-time-range) and [page filters](https://www.plain.com/docs/product/platform/dashboards/build-a-dashboard.md#filter-every-chart) apply to every chart, and a chart's own filters are combined with the page filters.

## Open a chart's options

Chart options are part of edit mode, and you save them with the rest of the dashboard.

**1. Start editing**

Click **Edit** at the top of the dashboard.

**2. Open the options**

Click the filter icon in the chart's corner. Its tooltip reads **Chart options**.

**3. Change the settings and save**

Change any of the settings below, then click **Save** at the top of the dashboard.

A chart shows only the settings that apply to it. **Chart type** appears when the metric can be drawn more than one way. **Percentile** appears on time charts, **Granularity** on **Line** and **Bars** charts, and **Rating** on CSAT score charts. A heatmap hides **Granularity**, **Group by**, **Percentile**, and **Rating**.

## Choose a chart type

The [chart catalog](https://www.plain.com/docs/product/platform/dashboards/chart-catalog.md) lists each metric once. Adding it uses that metric's default chart type. **Chart type** in the chart's options switches to another type the metric supports. The control is hidden when the metric has only one type, as with **First response SLA** and **Customers helped**.

The types are:

* **Number**: one figure for the chart's time frame
* **Line**: the metric drawn over time
* **Bars**: the metric drawn over time as bars
* **Breakdown**: one row per group, largest first, up to 5 groups
* **Heatmap**: one cell per hour (UTC) and day of the week

**CSAT responses**, **Agent messages sent**, and **Thread assignments** draw **Bars** as stacked bars. The other metrics draw a single series of bars.

**Line** and **Bars** draw the same series, so filters and group-by stay as they are. **Number**, **Breakdown**, and **Heatmap** keep the title, the description, the time frame, and the filters. **Number** doesn't keep a group-by. A type that can't keep the current settings is disabled. Hover it to read why. **Heatmap** is disabled when the time frame is shorter than 7 days, and its tooltip reads **Heatmaps need a time frame of at least 7 days.**

While you edit, switching back to a chart type restores the settings you last used for that type. **Save** keeps only the type that's selected.

## Filter a chart

Filters narrow a chart to the threads that match. Click **Add filter** in the chart's options and pick a dimension and value. Filters work the same as [Insights filters](https://www.plain.com/docs/product/platform/insights-filters.md): the same dimensions, such as assignee, label, account, tier, and thread field, and the same **AND** and **OR** groups.

[Page filters](https://www.plain.com/docs/product/platform/dashboards/build-a-dashboard.md#filter-every-chart) are separate. They apply to every chart, and Plain combines them with the chart's filters using **AND**. Page filters can't express **OR**. Put **OR** conditions on the chart.

When a chart has filters, the filter icon shows how many. Outside edit mode, the count stays in the chart's corner, so viewers can tell the chart is filtered.

If a chart has saved filters that the options can't display, its options read **This chart has filters that can't be edited here** in place of the filter controls. The filters still apply, and they count toward the number on the filter icon.

## Group a chart by a dimension

**Group by** splits a chart into one series or row per value of a dimension, such as tier, label, account, assignee, or a dropdown thread field. It offers the same dimensions as [group-by in Insights](https://www.plain.com/docs/product/platform/insights-filters.md#group-charts-by-a-dimension).

On a **Line** or **Bars** chart, choose **None** to draw a single series. With a dimension selected, the chart shows the 10 largest groups. A **Breakdown** always needs a dimension, doesn't offer **None**, and shows the 5 largest groups. Groups beyond those 5 are left off the chart.

**Group by** is hidden on **Number** charts, heatmaps, and charts that already split into fixed series. **CSAT responses** is split by rating. Team charts are split by the assigned user.

## Give a chart its own time frame

By default a chart follows the dashboard's time range, and **Time frame** shows **Dashboard default**. Pick a preset or **Custom** to give the chart its own time frame. The chart then shows its time frame under its title, and it no longer changes when someone changes the dashboard's range. Choose **Dashboard default** to follow the dashboard again.

**Customers helped** counts all time, so it has no time frame setting and ignores the dashboard's range.

## Change granularity

**Granularity** sets the size of each bar or point on **Line** and **Bars** charts, from hourly to yearly. The options you can pick depend on the length of the chart's time frame. For example, hourly needs a time frame of 7 days or less. See [Pick a timeframe and granularity](https://www.plain.com/docs/product/platform/insights-filters.md#pick-a-timeframe-and-granularity) for every limit.

## Choose a CSAT rating

**CSAT score** and **Agent CSAT score** have a **Rating** setting on every chart type they support. It starts on **Positive**. Choose **Neutral** or **Negative** to measure that rating instead. **CSAT responses** already splits all 3 ratings, so it has no **Rating** setting.

## Change the percentile

Time charts, such as **Resolution time**, show the median by default. That includes their **Number** and **Breakdown** types. Use **Percentile** to show **P75**, **P90**, **P95**, or **P99** instead. A heatmap has no percentile. See [Percentiles](https://www.plain.com/docs/product/platform/metrics.md#percentiles) for what each one means.

## Include or exclude machine users

**Users** decides whether a chart counts work done by machine users, such as AI agents and API integrations:

* **Humans and machine users**: counts both
* **Humans only**: leaves machine users out
* **Machine users only**: counts only machine users

The option marked **(default)** is what the metric uses in Insights. Only metrics that can tell humans and machine users apart show **Users**, and a chart with a setting other than its default shows that setting under its title. The info icon next to **Users** says how that metric decides which threads belong to machine users.

## Edit the title and description

Click a chart's title in edit mode to rename it. Titles can be up to 255 characters.

The description appears in a tooltip when you hover over the chart's title. Each chart starts with a description of what it counts, taken from the [chart catalog](https://www.plain.com/docs/product/platform/dashboards/chart-catalog.md). To change it, click **Edit** under **Description** in the chart's options, write up to 1,000 characters, and click **Save** in the description section. Then save the dashboard.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.