Indoor PM2.5 chart card with background

Who it’s for

Facility managers, building managers, and indoor air quality specialists ask “how has PM2.5 trended in this space recently?” The chart with background combines a trend line with a full-card color signal so current status is visible at a distance.

What it does

A sensor reporting pm2.5 = 18 µg/m³ renders a time-series trend chart on a card whose background color reflects the current severity: 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
• Trend chart of PM2.5 concentration over the selected dashboard time window
• Shows one sensor’s data per widget; add multiple widgets to compare trends and current status across spaces

How to set up

Data keys

Key	Role	Type	Description
pm2.5	Chart series	Timeseries	PM2.5 concentration in µg/m³; 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 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 time window — adjust the dashboard time filter to show the last hour, day, or week of PM2.5 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 PM2.5 severity from across the room while the embedded chart shows whether the level is a transient spike or a sustained elevation that requires investigation.
• Use consistent severity colors across all indoor air quality widgets so facilities staff can interpret a colored background anywhere on the dashboard without reading the label.
• A PM2.5 trend that gradually rises over several days without a single sharp spike suggests slow accumulation from a failing HVAC filter rather than an episodic combustion source — useful information when scheduling filter replacements.