Skip to main content
A single metric widget displays exactly one aggregated value in a large font — the simplest possible KPI tile. Use it when a single number tells the story: total spend this month, conversions to date, or click-through rate for a campaign.

​
When to use a single metric

  • One-number KPIs — the metric everyone should know at a glance.
  • Compact dashboard tiles — side-by-side comparisons across multiple single-metric widgets, each pinned to a different metric.
  • Executive rollups — the simplest way to communicate a single top-level number.
For multi-metric summaries, use the Overview widget. For target tracking, use the Goal widget.

​
Configure a single metric

​
Mandatory fields

1

Pick a data source

In the Data sources section, select the data source to include.
2

Pick a metric

Pick the metric shown as the widget’s value — for example, Spend, Impressions, or Conversions. Only one metric is displayed.
Widget changes save automatically when the settings panel closes. Persist changes to the dashboard by clicking Save dashboard.

​
Optional fields

  • Widget filter — narrow the data feeding the widget. See Filters.
  • Period — override the dashboard’s date range. See Date ranges.

​
Comparison mode

Single metric widgets support comparison mode. When the Compare toggle is on at the dashboard or widget level, the widget shows the current value alongside the comparison-period value, with a delta.

​
Conditional formatting

Single metric widgets support conditional formatting on the metric value’s text color. To set a rule:
  1. Click the waterdrop icon next to the metric value in the widget settings.
  2. Set a Single color rule with a condition and color.
For example: on a CPA single metric, apply Text color = red when CPA > $50, so the value renders red only when it crosses the target.
Single metric supports Single color mode only — not Color scale.

​
Empty state

When the metric returns no value in the current date range, the widget renders a dash (-) in place of the value.

​
Widget styling

Global widget style settings — font, border, background, and color themes — apply to every widget through the Dashboard style settings. On top of those, Single metric widgets have style options unique to this widget type:
  • Metric value font — weight, size (Auto or fixed), and HEX color for the aggregated value.
  • Number display — controls how the value renders:
    • Display format — Short scale (compact notation like 12.3K) or Full number (12,345).
    • Decimal digits — how many decimal places to show (for example, 0.0).
  • Icon — display an optional icon alongside the value. Icon type options:
    • None — no icon (default).
    • Data source — automatically uses the icon of the data source feeding the widget (for example, the Meta or Google Ads logo).
    • Icon — pick from a library of preset icons.
    When Icon type is anything other than None, the following properties can be customized: the icon choice from the library, Position (Left or Right of the value), Size (preset size list), and Color (HEX + opacity). Click Reset to clear icon properties back to defaults.

​
Troubleshooting

The metric returned no value in the current date range. Widen the date range, remove restrictive widget filters, or pick a metric that has data in the current window. See Data not loading.
The metric is aggregated according to its own definition (sum, average, or ratio, depending on the metric). Confirm that the metric picked matches the aggregation expected — for example, “Total Spend” for a sum, “Average CPC” for an average.

Overview widget

Multiple single-metric tiles in one widget.

Goal widget

Track this metric against a target.