Indoor horizontal PM2.5 card with background
Who it’s for
Facility managers, building managers, and indoor air quality specialists ask “can I monitor PM2.5 across many rooms in a compact layout where the severity is still instantly visible?” The horizontal background variant combines space efficiency with the full-card color signal.
What it does
A sensor reporting pm2.5 = 18 µg/m³ displays the reading in a horizontal card whose entire background fills with the severity color: light green for Good (0–35 µg/m³), orange for Moderate (35–75 µg/m³), and red for High (above 75 µg/m³).
- Full-card background color makes PM2.5 severity readable across a room without reading the number
- Horizontal layout fits more rooms per row on a multi-zone air quality dashboard
- 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 |
|---|---|---|---|
pm2.5 | Main value | Timeseries | PM2.5 concentration in µg/m³; change the key name to match your device’s telemetry key |
The widget ships with a simulated function datasource key labeled PM2.5, 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 (µg/m³) | Level | Color |
|---|---|---|
| 0–35 | Good | Light Green |
| 35–75 | Moderate | Orange |
| 75+ | 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
- A row of horizontal background cards, one per room, lets the facilities manager immediately identify which spaces have elevated PM2.5 during a building-wide event — such as a diesel generator test or a widespread candle-burning occasion — without scanning individual readings.
- Use consistent severity colors across all indoor air quality widgets: light green is safe, red needs action.
- For health and safety sign-off after activities that generate fine particles (soldering, spray painting, 3D printing), the colored row provides an instant multi-room clearance check before workers are allowed back in.
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.