---
title: "Gauge chart in Vista | Oplema"
description: "Show a calculated value on a fixed range with a Gauge in Vista, with an optional target and colored status zones so readers see where it stands."
url: "https://oplema.com/docs/vista/metrics/gauge"
updated: "2026-11-04"
---

# Gauge

Gauge shows a value calculated from source rows on a fixed range, with an optional target and status zones.

## Show team utilization

The support team's one row of utilization, 72%, sits on a fixed range from 0% to 100%.

Result
| Resource | Utilization percent |
| --- | --- |
| Support team | 72 |

1. In the Data tab, change Operation from `Average` to `Maximum` to see the highest value on the same range.
2. Expand Range and change the minimum or maximum. The arc fills to a different point.
3. Expand Target to add a marker for a target value.

## When to use

Use Gauge when the range gives the value its meaning, such as utilization, where 72% only makes sense between empty and full. To show progress toward a goal, use Progress. If there's no fixed range, Number is enough.

## Inputs

1 port

**Table**

Accepts: Tables.

Accepts one connection on this port.

## Settings

**Value**

Field to calculate. Automatic picks one, and Count rows needs none.

**Operation**

How the source rows become one value. Missing values are skipped.

Default: `Sum`

Options: Sum, Average, Median, Minimum, Maximum, 25th percentile, 75th percentile, 90th percentile, 95th percentile, Percentile, First by time, Last by time, Count values, Count distinct, Count rows, Count true, Percentage true.

**Label**

Text of the label.

37 more settings

**Show target**

Shows or hides the target.

Default: `false`

**Minimum**

Lowest value on the scale.

Default: `0`

**Maximum**

Highest value on the scale.

Default: `100`

**Source timezone**

IANA time zone for timestamps without an offset, such as Europe/Copenhagen. Ambiguous local times need an explicit offset.

Default: `UTC`

**Chart timezone**

IANA time zone used for grouping and display. Vista filters keep their own time zone.

Default: `UTC`

**Week starts**

Day the week starts on.

Default: `Monday`

Options: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.

**Fiscal year starts**

Month the fiscal year starts in. Sets quarter and year boundaries.

Default: `January`

Options: January, February, March, April, May, June, July, August, September, October, November, December.

**Show tooltip**

Shows or hides values when you hover over a mark.

Default: `true`

**Content**

Use the automatic details, or write your own text with calculated values.

Default: `Automatic`

Options: Automatic, Custom.

**Goal**

Whether higher, lower or staying inside a range is good.

Default: `Higher is better`

Options: Higher is better, Lower is better, Within a range.

**Show status**

Gives the value a status using limits you set in its own units.

Default: `false`

**Horizontal alignment**

Alignment of the content.

Default: `Center`

Options: Left, Center, Right.

**Vertical alignment**

Vertical position of the content in the card: top, center or bottom.

Default: `Center`

Options: Top, Center, Bottom.

**Value size**

Size of the value.

Default: `28`

**Label size**

Size of the label.

Default: `12`

**Value color**

Color of the value.

**Label color**

Color of the label.

**Show value**

Shows or hides the value.

Default: `true`

**Show label**

Shows or hides the label.

Default: `true`

**Content spacing**

Space between the parts of the card, in pixels (0-80).

Default: `6`

**Supporting text size**

Auto (0) matches Label size. Otherwise 10-80 pixels.

Default: `0`

**Show minimum and maximum**

Shows or hides the range labels. The range doesn't change.

Default: `true`

**Number format**

Percentage shows fractions multiplied by 100. Calculations keep the original units.

Default: `Automatic`

Options: Automatic, Number, Percentage.

**Decimals**

Number of decimal places.

Default: `0`

**Digit grouping**

Groups digits, so 2630 shows as 2,630.

Default: `true`

**Prefix**

Text before the value.

**Suffix**

Text after the value. Adding % doesn't multiply the value by 100.

**Scale**

Display unit for the value.

Default: `none`

Options: none, K, M, B.

**Accent color**

Accent color.

**Track color**

Color of the track.

**Shape**

Shape of the gauge.

Default: `Half circle`

Options: Half circle, Full circle.

**Arc thickness**

Thickness of the arc.

Default: `12`

**Gauge size**

How much of the available space the gauge fills, as a percent (10-100).

Default: `50`

**Rounded ends**

Rounds the ends of the arc. Joins between ranges stay square.

Default: `false`

**Background**

Card background color. Auto follows the theme.

**Corner radius (px)**

Corner radius in whole logical pixels.

Default: `0`

**Border width (px)**

Border width in whole logical pixels.

Default: `0`

## Gauge FAQs

**Where do I set the range?**

In the Data tab, under Range. This example uses 0 to 100.

**Can it show good and bad zones?**

Yes. Use Goal to set thresholds.

### Chart your data. Build it in Vista.

Vista opens in your browser, with no account.

[Open Vista](https://oplema.com/editor?path=%2F%3Fopen%3Dvista) [About Vista](https://oplema.com/vista)
