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

## Referencing the active granularity in labels

The custom value label and custom percentage label support a `${table_field.granularity}` placeholder that resolves to the active date granularity (for example `day`, `week`, `month`) — including the granularity selected via [date zoom](/guides/date-zoom). This can be set in Display configuration under Custom label.

See [Referencing the granularity in chart labels](/guides/date-zoom#referencing-the-granularity-in-chart-labels) for the full syntax and supported labels.