Simple volatile organic compounds chart card

Who it’s for

Indoor air quality managers, building managers, and health and safety officers ask “how has VOC concentration in this space trended over the last few hours or days?” They want a compact trend chart that fits into a multi-room overview without the overhead of a full chart card.

What it does

A sensor reporting voc = 320 ppb renders a time-series chart of those readings, color-coded by severity: green for Good (0–500 ppb), orange for Moderate (500–1000 ppb), and red for Hazardous (above 1000 ppb). The chart fills the card without a large numerical readout, maximizing the visible time window.

• Trend chart of VOC concentration over the selected dashboard time window
• Color-coded by severity at each point in time across three bands
• Shows one sensor’s data per widget; add multiple widgets to compare trends across rooms

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

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

• Use this chart in a grid alongside simple chart cards for CO2, humidity, and particulate matter to give facilities staff a side-by-side multi-parameter trend view without cluttering the dashboard with large value cards.
• A 12-hour time window showing the pattern around a cleaning or renovation event makes it easy to confirm that VOC levels peaked and then returned to the Good band before occupants returned.
• VOC trends that are still rising 4–6 hours after a source activity ended indicate inadequate ventilation; use the chart’s slope to estimate how many additional hours of fresh-air ventilation are needed.