---
title: "Gauge"
description: "A circular dial-based chart visualization for displaying single or multiple numeric values as indicators within a defined range, often with target thresholds."
group: Charts
tags: [Visualization, Chart, Dashboard, Gauge, KPI, Performance Indicator]
---
import { Aside, Steps } from '@astrojs/starlight/components';
# Gauge
The **Gauge Chart** is a dial-style visualization ideal for displaying numeric values relative to a scale, often representing KPIs or target-driven metrics.
It features a needle or pointer indicating the value position, with support for ranges, color zones, and optional target markers.
**Use cases:**
- Displaying **real-time KPIs or metrics**.
- Visualizing **progress towards a target**.
- Showing **performance against thresholds**.
- Tracking **single or multiple measures simultaneously**.
---
## ⚙️ Setup
1. Drag the **Gauge Chart** widget from the chart library onto your designer workspace.
2. Select the chart.
3. Go to the [Widget Configuration](/insights-v8/guide-to-infoboard-designer/customize-panel/configure/) tab in the Configuration panel.
4. Under the Configuration panel tab, select the [Basic Configuration](/insights-v8/guide-to-infoboard-designer/customize-panel/configure/#basic) option to access essential settings for the Gauge Chart.
5. Select the [Source](/insights-v8/guide-to-infoboard-designer/customize-panel/setup/#sources) from which the chart will fetch its data.
6. Map:
- **[Measure](/studio-v8/datasources/measures-dimensions-and-hierarchies/)** — Numeric value(s) to display on the gauge. Supports multiple measures for multi-dial charts.
7. Optionally add a **Date** field for time-based filtering.
---
## 📊 Basic Configuration
| Configuration Item | Description |
|:---------------------|:-------------|
| **[Source](/insights-v8/guide-to-infoboard-designer/customize-panel/setup/#sources)** | The data source to query for chart values. |
| **[Measure](/studio-v8/datasources/measures-dimensions-and-hierarchies/)** | Numeric value(s) to be represented by gauge needles. Can support multiple measures per chart. |
| **Date Field** (optional) | Enables date-based filtering and drilldown capability. |
---
## 🎨 Chart Customizations
| Category | Options & Description |
|:----------------------------|:-----------------------------------------------------------|
| **[General](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#general)** | Theme, background, border, and interactivity options. |
| **[Title](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#title)** | Chart title, font, alignment, and visibility settings. |
| **[Position](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#position)** | Adjust horizontal and vertical positioning of the gauge within the chart. |
| **[Series](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#series-customization)** | Define dial appearance, scale ranges, intervals, maximum value, target pointers, and dual progress indicators. |
| **Measures** | Customize gauge needle properties, color, dual pointer behavior, and value display formatting for each measure. |
| **[Tooltip](/insights-v8/guide-to-infoboard-designer/customize-panel/customization-tab/#tooltip)** | Tooltip content, format, and triggers on hover. |
| **Others** | Control dial rotation, anchor visibility, axis labels, split lines, and pointer styles. |
---
## 📊 Example Visualization
