---
title: "Gauge Chart"
slug: "gauge-chart-1"
updated: 2023-10-13T18:52:08Z
published: 2023-10-13T18:52:08Z
canonical: "docs.preset.io/gauge-chart-1"
---

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

# Gauge Chart

This chart type re-uses **gauge****s** from the scientific and industrial setting to showcase *partial progress towards a specific number*. They're also often referred to as speedometer charts (in references to dashboards in cars) or dial charts. Here are some examples:

![](https://cdn.document360.io/4749ddf8-aa05-4f3f-80e1-07a5d2d0f137/Images/Documentation/gauge1.png)

Gauge charts are simple, easy-to-understand charts that visualize one value at a time. They shine in KPI (or strategic) dashboards over a standard big number chart, where you want to succinctly communicate the progress towards a goal or KPI of interest (instead of just the metric itself).

### Reference Content

The following articles may be useful resources as you build your chart:

- [Creating a Chart](/v1/docs/creating-a-chart): A walkthrough of the overall process of chart selection and creation.
- [Using Preset Chart Builder](/v1/docs/using-preset-explore): How to work with the Chart Builder page, the primary interface used when creating a chart.

## Creating a Gauge Chart

**Simple Gauge Chart**

To create a gauge chart, the only required field is the **Metric** you want to visualize. To make a gauge chart useful though, you'll also want to customize the goal that maps to 100% of the gauge.

| ![](https://cdn.document360.io/4749ddf8-aa05-4f3f-80e1-07a5d2d0f137/Images/Documentation/Screen%20Shot%202022-09-19%20at%2010.09.39%20AM.png) | **Data -> Metric** - Choose the single, specific **Metric** you want visualized, similar to what you would select in a Big Number chart. |
| --- | --- |
| ![](https://cdn.document360.io/4749ddf8-aa05-4f3f-80e1-07a5d2d0f137/Images/Documentation/Screen%20Shot%202022-09-19%20at%2010.16.35%20AM.png) | **Customize -> Chart Options -> Min and Max** - **Min**: for many KPI's or target metrics, setting the **Min** value to 0 makes sense. - **Max**: usually you'll want to set your KPI or metric target as the **Max** value |

Here's the resulting chart:

![](https://cdn.document360.io/4749ddf8-aa05-4f3f-80e1-07a5d2d0f137/Images/Documentation/Screen%20Shot%202022-09-19%20at%2010.18.21%20AM.png)

**Gauge Chart with Dimensions**

In the following example, we're able split up the type of ride.

| ![](https://cdn.document360.io/4749ddf8-aa05-4f3f-80e1-07a5d2d0f137/Images/Documentation/gaurge4.jpg) | **Dimensions** - As with most charts in Preset, you can optionally add Dimensions to split up and color specific dimensions. The unique values in the chosen columns are used to split up the chart. |
| --- | --- |

Here's what the resulting chart looks like:

## ![](https://cdn.document360.io/4749ddf8-aa05-4f3f-80e1-07a5d2d0f137/Images/Documentation/Screen%20Shot%202022-09-19%20at%2010.27.52%20AM.png)

## Customizing your Gauge Chart

The **Customize** panel for a graph chart exposes a large variety of options to further clarify your chart. Here's a breakdown of some of these fields:

- **General**
  - **Min** and **Max**: let you specify the starting and ending values of the gauge chart.
  - **Start Angle** and **End Angle**: how you want the gauge to be angled
  - **Show Pointer**: if this checkbox is ticked, the dials from the center are shown (on by default).
  - **Animation**: if this checkbox is ticked, animation is used when updating the values or rendering the chart.
- **Axis**
  - **Show Axis Line Ticks**: if this checkbox is ticked, the minor split lines are shown along the gauge.
  - **Show Split Lines**: if this checkbox is ticked, the major split lines are shown along the gauge.
  - **Split Number**: slider for choosing the number of splits used for the split lines. Higher means more frequent and smaller distances between splits.
- **Progress**
  - **Show Progress**: if this checkbox is ticked, the partial progress bars are shown (on by default). We generally recommend keeping this enabled!
  - **Round Cap**: if this checkbox is ticked, the ends of bars are rounded off (instead of rectangular). Makes for better aesthetics!
  - **Overlap**: if this checkbox is ticked, dimension level progress bars stack together along a single bar. We generally recommend not ticking this if you have more than few dimensions!![](https://cdn.document360.io/4749ddf8-aa05-4f3f-80e1-07a5d2d0f137/Images/Documentation/Screen%20Shot%202022-09-19%20at%2010.43.52%20AM.png)