Skip to main content
Each chart on a dashboard 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 and page filters 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 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: the same dimensions, such as assignee, label, account, tier, and thread field, and the same AND and OR groups. Page filters 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. 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 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 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. 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.