Render: Recharts/custom · Category: Gauges and targets
A gauge that places a value within a range (min–max) against a target.
What it is#
A gauge that places a value within a range (min–max) against a target.
What it's for / when to use it#
Show target attainment at a glance (reached 82% of target).
When NOT to use it: Comparing several indicators — use Multi-KPI or Bullet.
Typical configuration fields#
- Minimum fields (wells): 1 metric + target
- Animated transition
- Chart scale/margin
- Toggle between chart and table
- Number format and decimal places
Usage example#
Monthly revenue target: needle at 82% of target (Aurora Varejo).
Required data#
A current measure + the target/range limits.
Limits and notes#
- The visual's data transformation and geometry are covered by automated tests on every release.
- Only controls that actually affect this visual are listed here (we avoid 'dead buttons').
Related#
- Visual catalog
- Visuals (overview)
- Editor, pages, layouts, and themes
- Filters and interactions
- Measures, formulas, and KPIs
Last reviewed: 2026-09-08.