← All chart types

specialized family

gauge

Single-value KPI on a half-circle dial.

A speedometer-style indicator showing one number against a range. Often colour-coded (red / yellow / green) for status. Common in dashboards as a "where are we" status check.

When to use

Single KPI you want to read at a glance.

When NOT to use

Comparing 2+ values (use bar).

Rhetorical roles

  • compare

Variants & related

Required primitives

  • has_data_labels

Optional primitives

  • has_title

Common anti-patterns

  • unfamiliar-encoding

Disambiguation rules

  • Half-circle (or quarter-circle) with a needle / pointer.
  • Often shown alongside other gauges in dashboard layouts.