Indoor humidity progress bar with background
Who it’s for
Facility managers, HVAC engineers, and building managers ask “where does the current humidity sit on the scale?” The background variant adds a full-card color signal to the progress bar so the comfort status is visible at a distance.
What it does
A sensor reporting humidity = 45% displays the value as a horizontal bar on a card whose background fills with the current comfort color: orange for Low (0–30%), green for Comfortable (30–60%), and red for High (above 60%).
- Full-card background color communicates comfort status at a glance from a distance
- Progress bar shows where the current value sits within the full humidity range
- Shows one sensor’s reading per widget; add multiple widgets to monitor different rooms
How to set up
Data keys
| Key | Role | Type | Description |
|---|---|---|---|
humidity | Bar value | Timeseries | Relative humidity in %; change the key name to match your device’s telemetry key |
The widget ships with a simulated function datasource key labeled humidity, 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 (%) | Level | Color |
|---|---|---|
| 0–30 | Low | Orange |
| 30–60 | Comfortable | Green |
| 60+ | High | Red |
How to customize
- To change the bar range — open the widget settings and adjust the minimum and maximum tick values (default 0–100%).
- To change the comfort thresholds — adjust the band boundaries to match your HVAC design specification.
- To change the background colors — edit the background color for each comfort band in the widget settings.
Tips
- On a wall-mounted building management display, the colored background gives staff an instant pass/fail read from across the room while the bar’s fill position shows how much headroom remains before the next band boundary.
- Use consistent comfort colors across all indoor environment widgets: green is comfortable, orange or red needs attention.
- Pair this widget with a temperature progress bar with background on the same row for a compact two-parameter comfort snapshot that works well on corridor-mounted status displays.
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.