Skip to content

Cookie preferences

We use cookies for our own analytics and to see how our campaigns perform. We never sell your data. Necessary cookies keep the site working and cannot be switched off. See our Cookie Policy for details.

Security, load balancing and remembering your cookie choice.

Show us which pages people read and how they find the site, so we can improve it (Google Analytics).

Show us which of our ad campaigns bring visitors to the site (Google Ads).

© 2026 The ThingsBoard Authors
Try for free

ThingsBoard Cloud

Choose your data region

Your data stays in the region you choose, for residency and compliance. No credit card required.

Rather run it yourself? Install on your own servers

Temperature Radial Gauge

Temperature radial gauge widget

The Temperature radial gauge is a circular dial styled after a physical thermostat, with a color-coded arc that transitions from blue on the cold end to orange-red on the warm end. Use it on HVAC dashboards, cold chain monitoring panels, or server room overviews where operators need an at-a-glance temperature indicator that makes out-of-range conditions immediately visible.

  1. Open the dashboard in edit mode. Click Add widget in the top toolbar, or click the Add new widget icon in the center of an empty dashboard.
  2. In the widget bundle selection dialog, find and click Analogue gauges.
  3. Select the Temperature radial gauge widget.
  4. Configure the datasource and appearance, then click Add.

All settings in this section use Basic mode — a quick-start configuration covering the essentials. For finer widget controls like title font, card style, and tooltip, switch to the Advanced tab.

Select the source of the temperature value:

  • Device — a specific device; the gauge displays the latest telemetry value from this device.
  • Entity alias — a set of entities matched by an entity alias; use this when the target device is selected dynamically at runtime.

Add exactly one data key — the telemetry key whose value the gauge will display (for example, temperature).

Controls the visual elements of the dial face.

Setting Description
Units title Toggle to show or hide the label displayed in the center of the dial. Enter the text (default: Temperature) and set its color and font.
Units The unit string shown below the title (default: °C). Set the display text, color, and font. Click the settings icon to configure unit conversion — see Unit conversion.
Value Toggle to show or hide the digital readout at the bottom of the dial. Set the number of digits and the text color and font.
Ticks The minimum and maximum values displayed on the scale (default: −60 to 60). Set tick label color and font.
Arrow and scale default color The color of the needle and the unmarked portion of the scale arc.
Plate color Background fill color of the gauge face.
Scale colors Toggle to enable the blue-to-orange gradient coloring of the scale arc. When off, the arc uses the arrow and scale default color uniformly.
Setting Description
Background color Solid color background for the widget card.
Show card buttons Toggle Data export and Fullscreen buttons in the widget header.
Card border radius Corner rounding in pixels.

The Temperature radial gauge supports the Widget header button action — a button placed in the widget header that triggers a configured action when clicked.

Gauge Shows No Data

Cause Solution
Wrong data key name Confirm the key name matches the telemetry key sent by the device. Key names are case-sensitive.
Device not sending data Open Devices → Latest telemetry and check for recent values. If empty, verify the device transport configuration and access token.
Entity alias resolves to no entities Open Entity aliases in the dashboard and verify the alias returns results.

Needle Is Pegged at the Minimum or Maximum

Cause Solution
Ticks range too narrow Increase the Ticks max value or decrease the min value to cover the expected temperature range.
Wrong telemetry key selected Confirm the data key matches the key your device actually reports.

Value Shows as N/A or Stops Updating

Cause Solution
Device has stopped sending telemetry Check device connectivity and the last activity timestamp in Devices → Latest telemetry.
Wrong datasource entity selected Verify the correct device or alias is selected in the datasource configuration.