Zira logo
AI plugins
Docs
Browse Guides
    What Is Zira
    Account Access

    5 guides

    Profile Preferences

    3 guides

    Navigation

    2 guides

    AI Vision

    13 guides

    AI Agents

    1 guide

    AI Assistance

    8 guides

    Data Sources

    12 guides

    Forms

    2 guides

    Dashboards

    18 guides

    Install the Zira App
    Chat

    1 guide

    Feed

    1 guide

    Tasks

    1 guide

    People

    2 guides

    Documents

    1 guide

    Applications

    1 guide

    Support

    1 guide

    Scheduler

    1 guide

    Triggers

    1 guide

    Inventory

    1 guide

    TVs

    1 guide

    Operations App

    2 guides

    TV App

    2 guides

    Channels

    1 guide

4 min read
Updated November 12, 2026

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
  1. Open a dashboard.
  2. Click Dashboard options next to the time range.
  3. Click Add widget.
  4. 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:

  1. choose the source channel or data context
  2. choose the metric or function
  3. choose the display style
  4. review the preview
  5. 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.

ValueShows
SUM, AVG, MIN, MAX, COUNTTotal, average, lowest, highest, and number of points
FIRST, LASTThe first and last point
MIN_MAX_RANGE, FIRST_LAST_RANGEHighest minus lowest, last minus first
METRIC, FUNCTIONThe metric and function names
FIRST_TIME, LAST_TIME, MIN_TIME, MAX_TIMEWhen that point happened, or its group name when the chart isn't grouped by time
FROM_DATE, TO_DATEThe dashboard's date range
FIRST_LAST_TIME_RANGETime 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.