Indoor CO2 card with background
Who it’s for
Facility managers, HVAC engineers, and building managers ask “can I see the CO2 status for every monitored room at a glance, without reading individual numbers?” The background-color variant is designed for building management dashboards where a single colored card must communicate ventilation adequacy from across a control room.
What it does
A sensor reporting co2 = 720 ppm displays the reading on a card whose entire background fills with the severity color: green for Good (0–600 ppm), orange for Moderate (600–800 ppm), and red for High (above 800 ppm).
- Full-card background color makes CO2 status readable across a room without reading the number
- Live CO2 reading in ppm
- Shows one sensor’s reading per widget; tile multiple widgets to monitor all rooms at a glance
How to set up
Data keys
| Key | Role | Type | Description |
|---|---|---|---|
co2 | Main value | Timeseries | CO2 concentration in ppm; change the key name to match your device’s telemetry key |
The widget ships with a simulated function datasource key labeled CO2 level, 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 (ppm) | Level | Color |
|---|---|---|
| 0–600 | Good | Green |
| 600–800 | Moderate | Orange |
| 800+ | High | Red |
How to customize
- To change the severity thresholds — edit Icon color ranges and Value color ranges; set the same boundaries in both so the icon and the number always agree.
- To change the background colors — edit the background color for each severity level in the widget settings.
- To rename the units label — change the Units field in the widget settings if needed.
Tips
- On a facilities management display with one card per meeting room, the background color lets the duty manager spot an over-occupied space instantly without scanning individual readings.
- Use consistent severity colors across all indoor air quality widgets: green is safe, red needs attention.
- For demand-controlled ventilation systems, pair this card with HVAC status widgets so operators can confirm that a red CO2 card triggers a corresponding increase in supply air volume.
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.