> ## Documentation Index
> Fetch the complete documentation index at: https://lightdash-mintlify-cccf65ca.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Gauge

> Use gauges to highlight a single value against a qualitative range, like performance against a target.

<Frame>
  <img src="https://mintcdn.com/lightdash-mintlify-cccf65ca/8jl62BZ1l-L8wRh0/images/references/chart-types/gauge-chart.png?fit=max&auto=format&n=8jl62BZ1l-L8wRh0&q=85&s=e1850f3542ed36285a1fa58170a94dcd" alt="" width="744" height="582" data-path="images/references/chart-types/gauge-chart.png" />
</Frame>

Gauges are useful when you want to highlight a single value against a qualitative range, like performance against a target. They work well for KPIs and operational dashboards where you need an at-a-glance status.

To create a gauge chart:

* Choose a single metric as the value to display.
* Optionally define min and max bounds for the scale.
* Configure colored ranges to communicate thresholds (for example: red, amber, green bands).

Tips:

* Use gauges sparingly and for monitoring, not detailed analysis.
* Prefer descriptive labels and units so the value is immediately clear to viewers.
