Indoor temperature gauge
Who it’s for
Facility managers, building managers, and smart home owners ask “where does the current temperature sit within the full expected range for this space?” A radial gauge communicates both the absolute value and its position within the comfort envelope in a single glance.
What it does
A sensor reporting temperature = 21°C positions a needle on a radial gauge spanning 0–40°C, with the arc divided into three highlight zones: blue for Cold (0–18°C), light green for Comfortable (18–24°C), and red for Hot (24–40°C).
- Radial gauge positions the needle within the full 0–40°C operating range for immediate context
- Color-coded arc zones show Cold, Comfortable, and Hot bands without requiring the viewer to read the scale
- Shows one sensor’s reading per widget; add multiple widgets to monitor different rooms or zones
How to set up
Data keys
| Key | Role | Type | Description |
|---|---|---|---|
temperature | Gauge value | Timeseries | Indoor temperature in °C; change the key name to match your device’s telemetry key |
The widget ships with a simulated function datasource key labeled Temperature, so it draws random values until you point the datasource at a device and rename the key.
To point it at your own device: open the dashboard in edit mode, open the widget’s Datasources, pick the entity or entity alias, and replace the function key with the key your device reports.
Value ranges
| Range (°C) | Level | Color |
|---|---|---|
| 0–18 | Cold | Blue |
| 18–24 | Comfortable | Green |
| 24–40 | Hot | Red |
How to customize
- To change the gauge range — open the widget settings and adjust the minimum and maximum values to match your expected temperature range.
- To change the comfort thresholds — adjust the arc zone boundaries in the widget settings.
- To change the zone colors — edit the color for each zone in the widget settings.
Tips
- A needle sitting in the blue zone with the HVAC in heating mode tells an operator immediately whether the system is working; a needle deep in the red zone alongside a Heat call confirms the space cannot keep up, pointing to insufficient heating capacity or excessive heat gains.
- The gauge’s analog format is intuitive for non-technical occupants on a lobby kiosk display — they understand “in the green zone” without needing to know that 21°C is the setpoint.
- For server rooms and cold storage, adjust the comfort zone boundaries to match the required operating range (for example, 18–27°C for a server room) so the gauge highlights any exceedance of the actual thermal envelope.
Share Your Widget with the Community
Built a custom widget? Export it as a JSON from ThingsBoard and publish it to the IoT Hub through a simple 4-step wizard (Upload, Listing, Readme, Review & Submit). Share it with thousands of ThingsBoard developers worldwide and get featured in the catalog.