Browse Guides
5 guides
3 guides
2 guides
13 guides
1 guide
8 guides
12 guides
2 guides
18 guides
1 guide
1 guide
1 guide
2 guides
1 guide
1 guide
1 guide
1 guide
1 guide
1 guide
1 guide
2 guides
2 guides
1 guide
Data Research Widgets
Use data research widgets to show KPIs, grouped values, chart trends, and visual summaries from dashboard data sources.
Use data research widgets when you want to turn readings into a dashboard view that is easy to scan.
These widgets depend on the right data source and metric context being available first.
Open the data research widget menu
- Open a dashboard.
- Click Dashboard options next to the time range.
- Click Add widget.
- Open the Data Research category.
KPI
Use KPI to highlight one primary value.
This widget can also show:
- comparison to the previous time period
- a trend view
- gauges
- color ranges
- formatted time output
Use it when one value is the main story on the page.
Grouped KPI
Use Grouped KPI when you want KPI-style values split by a grouping dimension instead of shown as one total.
This is useful when the same metric needs to be compared across categories.
KPI Table
Use KPI Table when you want a tabular KPI summary instead of a single-value card.
This is useful when the dashboard should show several KPIs together in one compact block.
Column
Use Column when you want a vertical comparison between values or categories.
This is a good choice when users need to compare magnitudes quickly.
Bar
Use Bar when the same comparison reads better horizontally, especially when labels are longer or category names take more space.
Pie
Use Pie when the main question is how a total is split across parts.
Use it carefully. It works best when there are only a few segments and the relationship between parts matters more than exact value comparison.
Turn on Show Legend in the chart options when the slice labels are hard to read on the chart itself, or when you want the segment names listed beside it.
Time series
Use Time series when the change over time is the main story.
This widget is useful for trends, direction, seasonality, and before-versus-after review.
Indicator
Use Indicator when you want a compact at-a-glance signal rather than a full chart.
This widget is useful when the dashboard needs a fast visual status check.
If the field you point it at is a yes/no field, the indicator now reads True or False instead of a raw value, so a status tile says what it means without extra setup.
Common setup pattern
Most data research widgets follow a similar setup:
- choose the source channel or data context
- choose the metric or function
- choose the display style
- review the preview
- save the widget
Show live values in series names
You can put live values from a series into its name, so the legend says more than the metric. In the widget editor, type the name in the series' Label field and wrap each value in ${…}:
Total (${SUM})shows Total (1387).Peak ${MAX} at ${MAX_TIME}shows the highest value and when it happened.Fail ${round(AVG, 1)}%shows the average with one decimal. Values under 100 keep their decimals; from 100 the name shows whole numbers.
The values come from the points shown in the chart for the selected date range, and they update with the chart.
| Value | Shows |
|---|---|
SUM, AVG, MIN, MAX, COUNT | Total, average, lowest, highest, and number of points |
FIRST, LAST | The first and last point |
MIN_MAX_RANGE, FIRST_LAST_RANGE | Highest minus lowest, last minus first |
METRIC, FUNCTION | The metric and function names |
FIRST_TIME, LAST_TIME, MIN_TIME, MAX_TIME | When that point happened, or its group name when the chart isn't grouped by time |
FROM_DATE, TO_DATE | The dashboard's date range |
FIRST_LAST_TIME_RANGE | Time from the first to the last point, such as 8h |
You can also use math and the same functions as custom aggregations, such as round, max, datesDiff and formatDate. Names are case-sensitive: write SUM, not sum. Anything that can't be worked out is shown as typed.
Changing a series' label also changes the ID that custom aggregations use to refer to it. If a custom aggregation still uses the old ID, the editor shows a warning above Custom Aggregations. Click Update to switch it to the new ID.
Stacked series and empty values
When a series is stacked by another field, such as Rule Name, each value gets its own segment.
- Readings with no value in that field are grouped into one segment, such as Defects (no Rule Name). The segments add up to the series total.
- The series' filters apply before stacking. A value that has no readings left after the filters doesn't appear in the legend.
- To leave out readings with no value, open the series filters and add the stacking field with IS NOT EMPTY.
IS NOT EMPTY keeps readings that have a value. Readings with no value or with blank text are left out.
Tips
- Use KPI and Indicator for summary rows and top-of-page status.
- Use Column, Bar, Pie, and Time series when users need more explanation and pattern recognition.
- Use KPI Table when the dashboard needs a compact operational summary without many separate cards.