Quick Stat Bars: Several Quick Stats on One Titled Bar
A quick stat bar puts several quick stats side by side inside one framed widget with a shared title. It is built for wallboards and TV dashboards, where a group of related numbers ("Support desk": created, solved, reopened, closed) should read as one block without each number taking its own tile and title row.
A bar is about one quick stat tall plus a slim title strip, holds up to six stats, runs one set of filters that every stat follows by default, and takes your color templates and formats like any other widget.
Before you start
You need edit rights on the dashboard. Bars are added and changed in edit mode, by anyone who can edit the dashboard. Viewers see the finished bar.
A bar holds quick stats. Any metric from the Quick stat type of the widget library can go on a bar: counts, percentages, averages and live numbers alike.
Up to six stats per bar. For more numbers, add a second bar.
Step 1: Add a bar
Open the dashboard and click Edit. The Draggable widgets strip appears under the top bar.
Drag the Quick stat bar chip into the dashboard. It lands as a new row.
Click the pencil beside the bar's title and type a name. The title sits inside the frame, in the upper left.
The bar's top bar holds its controls: the funnel for the bar's filters (with its date range beside it), the bar / column layout toggle, Format, Clone, Delete and Refresh. There is no separate edit dialog; the bar is edited right on the card.
Step 2: Add and arrange the stats
Click the + Add stat tile at the end of the bar. The widget library opens on its quick stats; search or browse a category, pick a metric and click Add widget.
Each stat shows its number with its name underneath. Click the pencil beside the name to rename it ("Created" instead of "Tickets Created" keeps a wallboard readable).
Drag a stat to change its place in the bar.
Hover a stat in edit mode for its actions: its own filters, Format, the settings gear (change the metric or its settings), Clone and Remove.
When the bar holds six stats the add tile reads 6 of 6; remove or move one to add another. Clone a stat to start a new one from the same metric and filters.
Bar or column. The layout toggle on the bar's top bar switches between a wide bar, with the stats side by side, and a tall column, with the stats stacked. A column shows three stats at a time and scrolls past three, which suits a narrow spot beside a chart.
Step 3: Filters: one set for the bar, or a stat's own
A bar has one filter set, behind the funnel on its top bar, and every stat runs it by default. Set the date range and the ticket, agent or group filters once and the whole bar follows, so "Support desk, last 7 days" means the same thing for every number on it.
A stat can run its own filters instead:
In edit mode, hover the stat and click its funnel. The filters lightbox opens prefilled with the bar's filters.
Change what you need and apply. The stat now runs these filters in place of the bar's (the two are never mixed), and its date range shows in its corner.
To return it to the bar's filters, open the same lightbox and click Follow the bar's filters.
In view mode a stat on its own filters shows a small funnel in its corner. Click it to see exactly which filters its last load ran, in the same Applied Filters flydown every widget's top bar has.
The tab's quick filters bar applies on top of either, for a stat on the bar's filters and a stat on its own alike. See Quick Filters Bar on Dashboards and the Comprehensive Guide to Filters.
Step 4: Format the bar and its stats
The bar takes color templates and widget formatting like any other widget, so it matches the rest of a styled dashboard in light and dark mode. Click the paint roller on the bar's top bar to give the bar a template or colors of its own; every stat on it is painted with them.
A single stat can carry its own format on top: hover it in edit mode and click its paint roller. Format quick stat opens on that cell, with a preview in light and dark mode, a template picker and the tile, value, title, icon and good/bad colors. A stat's own format wins over the bar's for that cell.
Templates, themes and the color permissions are covered in Color Themes, Color Templates and Widget Formatting.
Over the User Access API
Everything above is available through the User Access API, addressed by the bar's dashboard widget id:
list_quick_stat_bar_stats: the bar's stats, in order, with each one's metric, name, filters and whether it runs its own.add_quick_stat_bar_stat,update_quick_stat_bar_stat(metric, name, filters,uses_own_filters),clone_quick_stat_bar_stat,remove_quick_stat_bar_stat,reorder_quick_stat_bar_stats.move_widget_into_quick_stat_barandmove_quick_stat_out_of_bar: turn an existing quick stat widget on the dashboard into a stat on a bar, or lift a stat back out as its own widget.
A stat's format goes through the same format tools as a widget's (format_dashboard_widget, apply_color_template_to_widgets), passing the stat's id.
Troubleshooting
No "Quick stat bar" chip. The strip only shows in edit mode. Click Edit on the dashboard; if there is no Edit button you don't have edit rights on it.
The add tile says "6 of 6". The bar is full. Remove a stat, or add a second bar.
A stat shows a different number from the same quick stat elsewhere. Check whose filters it runs: the bar's (the funnel on the bar's top bar) or its own (the funnel in the stat's corner). The Applied Filters flydown shows what its last load used.
No paint roller on the bar or its stats. Widget formatting is switched on per account and per user. An admin grants the color permissions under Settings → Manage Account Members; see the formatting article above.
A stat reads "Couldn't load". Each stat loads on its own, so one slow or failing metric doesn't take the bar down. Click Refresh on the bar; if it persists, open the stat's settings gear and check its metric and filters.
Related: Customizing Your Dashboard: Adding Rows and Widgets and Free-Size Widgets: Resize and Arrange Your Dashboard.





