---
title: "Gauge widget"
slug: "gauge-widget"
updated: 2026-03-20T14:23:24Z
published: 2026-03-20T14:23:24Z
canonical: "docs.calculus.group/gauge-widget"
---

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

# Gauge widget

The gauge widget is used to display a value, in relation to a maximum value on a scale. The widget will change color as the value increases. A practical example of this, is the fuel gauge in your car.

![Fuel gauge displaying 95.4% fuel level, indicating nearly full tank capacity.](https://cdn.document360.io/94d0a983-5058-4b02-8d06-1228a999a7a1/Images/Documentation/gauge.png?sv=2026-02-06&spr=https&st=2026-11-11T14%3A02%3A53Z&se=2026-11-11T15%3A02%3A53Z&sr=c&sp=r&sig=kKpUbK81G5MZ8QIoMlP%2BkWO6bfc7RMiGTYBzvpi9uEA%3D)

## Widget control elements

- **Context menu** Lets you select a date range, or download the data in various formats.

## Widget configuration panel

In the widget selection panel, click on **Gauge**. A new panel will appear where you can configure the widget.

### Gauge data

![Dashboard interface displaying gauge settings and data source options for asset tracking.](https://cdn.document360.io/94d0a983-5058-4b02-8d06-1228a999a7a1/Images/Documentation/2025-08-13 15-40-14.png?sv=2026-02-06&spr=https&st=2026-11-11T14%3A02%3A53Z&se=2026-11-11T15%3A02%3A53Z&sr=c&sp=r&sig=kKpUbK81G5MZ8QIoMlP%2BkWO6bfc7RMiGTYBzvpi9uEA%3D)

Fill in the fields below:

- **Computed measurement** If enabled, you can use a formula to determine the value shown.
- **DataSource** Where the data is sourced from.
- **Sensor** What data you want to display.
- **Aggregation** The aggregation of the incoming data:
  - **MIN:** shows the minimum value.
  - **MAX:** shows the maximum value.
  - **SUM**: calculates the sum of all values.
  - **AVG:** calculates the average value.
  - **COUNT:** counts the number of values.
  - **FIRST:** shows the first value.
  - **LAST:** shows the last value.
  - **DIFF:** calculates the difference between the first and last value.
- **Dynamic Maximum Value** If enabled, automatically adjusts the maximum value.
- **Maximum value** The value corresponding to a full gauge.
- **Decimals** Up to how many decimal places the value should be displayed.

Click **Next** to go to Gauge settings.

### Gauge settings

![Dashboard settings for a gauge widget with various configuration options displayed.](https://cdn.document360.io/94d0a983-5058-4b02-8d06-1228a999a7a1/Images/Documentation/2025-08-13 15-40-26.png?sv=2026-02-06&spr=https&st=2026-11-11T14%3A02%3A53Z&se=2026-11-11T15%3A02%3A53Z&sr=c&sp=r&sig=kKpUbK81G5MZ8QIoMlP%2BkWO6bfc7RMiGTYBzvpi9uEA%3D)

Fill in the fields below:

- **Title** A title or description for the widget.
- **Widget width** The width in relation to the screen width.
- **Height** The height of the widget in pixels.
- **Order** The position on the dashboard.
- **Suffix** A suffix for the measurement.
- **Invert color** Reverses the direction of the color transition.
- **Refresh in seconds** Leave this at the default.

Click **Save** to add the widget to the dashboard.