---
title: "The Gauge Object – Display Key Performance Indicators in Board"
slug: "the-gauge-object"
description: "Learn how the Board Gauge Object shows metrics at a glance: configure ranges, thresholds, and colors to visualize performance indicators dynamically."
tags: ["Objects", "Developer", "Planner", "Gauge", "Power User"]
updated: 2026-01-29T10:02:45Z
published: 2026-03-31T09:00:24Z
canonical: "help.board.com/the-gauge-object"
---

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

# The Gauge Object

The Gauge Object displays and represents numerical values through a circular or semicircular meter or a linear meter (horizontal or vertical). It is typically used to show various types of quantitative data and is usually included into visual dashboards.

You can customize the Gauge Object using the formatting options [common to all Screen Objects](/v1/docs/about-screen-objects#options-common-to-all-screen-objects) and configure up to two threshold values to be displayed in labels or as markers along the progress bar.

## Example

The following image shows a simple sales reporting dashboard with a few customized Gauge Objects representing different values with a marker indicating the target.

![contents/assets/images/guage.about.object.png](https://cdn.document360.io/8d6f1ae8-0cac-4d0d-a208-6245b83df94a/Images/Documentation/the-gauge-object-image-xnz66piw.png)