Volatile organic compounds chart card

Who it’s for

Indoor air quality managers, building managers, and health and safety officers ask “what is the VOC level in this space right now, and has it been building up over the past few hours?” They need both the current reading and the trend to determine whether elevated VOCs are a brief post-cleaning spike or a persistent problem requiring remediation.

What it does

A sensor reporting voc = 320 ppb shows the current value color-coded by severity alongside a time-series chart of recent readings: green for Good (0–500 ppb), orange for Moderate (500–1000 ppb), and red for Hazardous (above 1000 ppb). The chart lets facilities staff see whether elevated VOCs are clearing with ventilation or continuing to rise.

• Live VOC reading in ppb with color coding across three severity bands
• Historical trend chart shows how VOC concentration has evolved over the selected time window
• Shows one sensor’s data per widget; add multiple widgets to monitor different rooms or zones

How to set up

Data keys

Key	Role	Type	Description
voc	Chart series	Timeseries	VOC concentration in ppb; 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 VOCs, 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–500	Good	Green
500–1000	Moderate	Orange
1000+	Hazardous	Red

How to customize

• To change the time window — adjust the dashboard time filter to show the last hour, day, or week of VOC readings.
• To change the severity thresholds — edit the color ranges on the Latest data key to match your organization’s indoor air quality policy.
• To change the chart colors — edit the color of each range on the Latest data key.

Tips

• A chart spanning 4–8 hours captures the full lifecycle of a VOC event — the spike from a cleaning product or adhesive, the plateau while the space is closed, and the decline as ventilation clears the air — so facilities staff can confirm the space is safe before occupants return.
• VOC levels that plateau rather than declining steadily after a source activity indicate the ventilation rate is insufficient; use the chart to determine how many air changes are actually needed to bring the space into the Good band within a target timeframe.
• For health and safety compliance, export the time-series covering the event period alongside a note of what activity caused the spike so incident logs are self-explanatory.