Indoor CO2 chart card with background
Who it’s for
Facility managers, HVAC engineers, and building managers ask “how has CO2 trended in this space recently?” The chart with background combines a compact trend line with a full-card color signal so the current status is visible at a distance.
What it does
A sensor reporting co2 = 720 ppm renders a time-series trend chart on a card whose background color reflects the current severity: 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
- Trend chart of CO2 concentration over the selected dashboard time window
- Shows one sensor’s data per widget; add multiple widgets to compare trends and current status across rooms
How to set up
Data keys
| Key | Role | Type | Description |
|---|---|---|---|
co2 | Chart series | Timeseries | CO2 concentration in ppm; change the key name to match your device’s telemetry key |
| Latest | Latest value | Timeseries | The headline figure above the chart. Its own color ranges are where the band colors are edited |
| Delta percent | Percentage change | Timeseries | Change against the previous period, as a percentage |
| Delta absolute | Absolute change | Timeseries | Change against the previous period, in the key’s own unit |
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 time window — adjust the dashboard time filter to show the last hour, day, or week of CO2 readings.
- To change the severity thresholds — edit the color ranges on the Latest data key.
- To change the background colors — edit the color of each range on the Latest data key.
Tips
- On a wall display, the colored background signals the current CO2 severity from across the room while the embedded chart shows whether levels are recovering or still rising.
- Use consistent severity colors across all indoor air quality widgets so facilities staff can interpret a red background anywhere on the dashboard without reading the label.
- CO2 that plateaus in the Moderate band for hours — rather than spiking and recovering — indicates continuous mild over-occupancy, which is often harder to spot without a trend view than a single high-peak event.
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.