Gauge Chart – QBeeQ | Documentation

The Gauge Chart is a single-value visualization plugin that displays a numeric metric against a set of color-coded bands, giving viewers an immediate read on whether a value is within an acceptable range. Bands are defined using Sisense's native conditional coloring, so designers can use formulas and dynamic thresholds without any additional configuration.

📄

Release notes for the Gauge chart can be found here.

Installation and configuration

The Gauge Chart plugin can be installed by an Admin, following the directions in Installing QBeeQ Plugins.

Operating system and version support:

Linux - Latest

Windows - Latest

Creating a Gauge Chart

To create a new Gauge Chart:

Choose QBeeQ Gauge Chart from the widget dropdown list

Select data as Value, Min and Max in the Data Panel

Configure band colors and ranges in the Data Panel

Configure chart using the settings in the Design Panel

Select data

The data panel accepts three inputs: Value, Min, and Max.

Value is required; Min and Max are optional and can be connected to dynamic data or left at their defaults.

Data	Required	Description	Behavior
`Value`	Yes	The measure to display on the gauge.	Conditional coloring on this measure defines the gauge bands. Accepts numeric values
`Min`	No	Sets the lower bound of the gauge scale.	Can be connected to dynamic data using formulas, or left at defaults Default: 0 Accepts negative values
`Max`	No	Sets the upper bound of the gauge scale.	Can be connected to dynamic data using formulas, or left at defaults Default: 100

Configuring bands

Bands are created and managed through the conditional coloring on the Value measure in the data panel. Each color condition you define maps to one band on the gauge. The condition's threshold values set the band range, and the assigned color sets the band color. When a condition is added, edited, or removed, the gauge updates automatically on save.

ℹ️

At least one condition must be defined for the gauge to render bands.

Bands are created and managed through the conditional coloring controls on the value measure in the data panel. When a condition is added, edited, or removed, a color swatch and text input are added to the Band labels section of the Design Panel.

Property	Description	Behavior
Band range	Determined by the condition's threshold values	Updating a condition's threshold values in the conditional coloring will resize the band on the gauge on save.
Band color	Set by the color assigned to the condition	Changing a condition's color in the conditional coloring will update the corresponding band color on save.
Band distribution	Controls how arc space is allocated across bands	Defaults to relative, where each band's arc width is proportional to its numeric range relative to the total scale span.

Design panel settings

The design panel is organized into four sections: Shape and distribution, Band labels, Scale, and Needle. Settings in each section apply globally to the widget.

Setting	Description	Behavior
Gauge shape	Sets the arc span of the gauge. Choose from 180°, 220°, or 260°.	Choose from `180°`, `220°`, or `260°`
Label text	Optional text labels for each band are configured in the design panel. Each band displays a read-only color swatch alongside a text input.	Displayed on the gauge when Show labels is set to On bands or As legend. Leave blank to show no label for that band. To adjust band colors, use conditional coloring in the data panel.
Show labels	Controls where band labels appear	As legend displays labels outside the gauge arc. On bands displays labels directly within each band.
Display ticks	When enabled, tick marks are shown along the gauge arc.	Default: On
Needle color	Sets the color of the needle	Automatically matches the conditional color of the active band
Needle value	Controls where the current value is displayed relative to the needle.	Options: No value, On needle (default), Below needle
Value color	Sets the color of the value text displayed on or below the needle.	ℹ️ Available when Needle value is set to `On needle` or `Below needle`