> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usedatabrain.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gauge, Progress Bar, and Linear Gauge

> Set up Gauge V2, Progress Bar, Progress Bar V2, Linear Gauge, and Linear Gauge V2 for single-value KPIs.

Gauge, Progress Bar, and Linear Gauge show **one main value** or progress toward a target.

<Tip>
  **Gauge V1 is deprecated.** If you see a message to use Gauge V2 instead, choose **Gauge V2** from the chart type list. Gauge V2 offers improved styling and options.
</Tip>

## Chart Types

| Chart               | Use case                                     |
| ------------------- | -------------------------------------------- |
| **Gauge V2**        | Radial gauge; score or utilization %         |
| **Progress Bar**    | Horizontal bar; % complete or usage vs limit |
| **Progress Bar V2** | Updated progress bar                         |
| **Linear Gauge**    | Horizontal scale with segments/thresholds    |
| **Linear Gauge V2** | Updated linear gauge                         |

## Data Requirements

* One **measure** (the value to display)
* Optional: **Progress max** and **Progress min** columns for range (Progress Bar, Linear Gauge)
* Optional: **Dimensions** for gauge breakdown (Gauge V2)

## How to Set Up

1. Create a metric with at least one measure. For progress, add optional min/max columns.
2. Click the **Charts** icon and choose the chart type.
3. Click **Settings** → **Chart types** → **Chart properties**.
4. Under **Required Axis**:
   * **Gauge V2**: **Measure** (metric) and optional **Dimensions** for breakdown.
   * **Progress Bar / Linear Gauge**: **Measure** (progress column). Optionally set **Progress max** and **Progress min** columns in chart configuration.

## Min and Max

In **Appearance** or chart configuration:

* Set **Min** and **Max** for the scale (e.g., 0–100 for %, or 0–capacity for usage).
* If not set, the app may use the measure range or 0–100.

## Thresholds (Gauge and Linear Gauge)

Thresholds color parts of the scale (e.g., green 0–60, yellow 60–80, red 80–100). Configure in **Appearance** → chart-specific settings.

## Formatting

Set **Prefix** (e.g., "\$") and **Suffix** (e.g., "%", "K") in **Appearance** → **Formatting**.