Horizontal carbon monoxide (CO) card with background
Who it’s for
Environmental health officers, air quality managers, and smart city operators ask “can I see the CO severity for many stations in a compact layout where the status is immediately obvious?” The horizontal background variant combines the space efficiency of the horizontal layout with full-card color coding for maximum visual clarity in crowded dashboards.
What it does
A monitoring station reporting carbon = 3.2 mg/m³ displays the reading in a wide, low-height card whose entire background fills with the severity color: green for Good (0–5 mg/m³), light green for Moderate (5–10 mg/m³), orange for Elevated (10–25 mg/m³), dark orange for High (25–50 mg/m³), and red for Hazardous (above 50 mg/m³).
- Full-card background color in a compact horizontal format makes severity obvious without reading the number
- Live CO reading in mg/m³
- Shows one sensor’s reading per widget; stack multiple widgets to cover an entire network in a narrow column
How to set up
Data keys
| Key | Role | Type | Description |
|---|---|---|---|
carbon | Main value | Timeseries | Carbon monoxide concentration in mg/m³; change the key name to match your device’s telemetry key |
The widget ships with a simulated function datasource key labeled Carbon monoxide, 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–5 | Good | Green |
| 5–10 | Moderate | Light Green |
| 10–25 | Elevated | Orange |
| 25–50 | High | Dark Orange |
| 50+ | Hazardous | 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 band colors — edit the color of each range in Icon color ranges and Value color ranges.
- To rename the units label — change the Units field in the widget settings if your sensor reports in ppm instead of mg/m³.
Tips
- Stack horizontal CO cards with colored backgrounds in a sidebar next to a map to let operators instantly spot which station needs attention without reading individual values.
- Use consistent severity colors across all air quality widgets so a red background anywhere on the dashboard means the same thing without needing to read the label.
- For compliance reporting, pair this card with a CO chart card so inspectors see both the current reading and the daily trend without switching views.
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.