Indoor PM2.5 card

Who it’s for

Facility managers, building managers, and indoor air quality specialists ask “what is the PM2.5 fine particulate level in this space right now?” They need an instant, color-coded reading to assess whether combustion particles from cooking, printing, or nearby traffic are affecting the indoor environment.

What it does

A sensor reporting pm2.5 = 18 µg/m³ displays the reading on a card with the value color-coded by severity: light green for Good (0–35 µg/m³), orange for Moderate (35–75 µg/m³), and red for High (above 75 µg/m³).

• Live PM2.5 reading in µg/m³ with automatic color coding across three severity bands
• Instant severity signal lets staff act on fine particulate exceedances without interpreting raw numbers
• Shows one sensor’s reading per widget; tile multiple widgets to monitor all zones 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 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 needed.

Tips

• PM2.5 particles (smaller than 2.5 µm) penetrate deeper into the lungs than PM10, so a Moderate PM2.5 reading warrants faster intervention — particularly in spaces occupied by children, the elderly, or people with respiratory conditions.
• If PM2.5 is elevated while PM10 is normal, the source is likely fine combustion (candles, cooking, 3D printing filament) rather than coarse dust — a distinction that determines whether opening a window or eliminating the source is the right response.
• For health and safety compliance in laboratories and print rooms, set the High threshold to 35 µg/m³ (WHO guideline level) to trigger alerts before the default 75 µg/m³ moderate-band upper limit.