> ## Documentation Index
> Fetch the complete documentation index at: https://lightdash-mintlify-ca973f84.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-ca973f84/pI4NcVAb2FsV-fze/images/references/chart-types/gauge-chart.png?fit=max&auto=format&n=pI4NcVAb2FsV-fze&q=85&s=8127684806563913e192b2e5fa8e3331" 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.