AirGradient Forum

Documentation on using (not building) the unit anywhere?

After a week, loving the unit, it’s giving me some great insights! However, initial impressions were a little rough, as was the install. Is there any documentation on using the Air Gradient platform? It’s mostly self explanatory, but I thought I read that you could set what sensor is driving the colored LEDs, so e.g. if you care only about VOCs, you could map it to that.

All I can find is instructions on building the kit, and on the various integrations. Thanks,

Hi @B_C! Documentation is in the works. I believe we should have the basic version ready in about 2 weeks time.

But yes, if you enable Advanced Config in General Settings:

CleanShot 2026-01-14 at 11 .32.26@2x

A new LED & Display tab will appear where you can map the LEDs to either PM2.5 or CO2.

Ah, ok I did have the Advanced Configuration checkbox ticked, but yeah didn’t see that that made a new tab, so thanks. Ok, unfortunately, it looks like you can only map LED lights to PM2.5 or CO2? Why no option for VOC?

There is some user‑made documentation and tips in the forum pinned posts that cover using the platform and LED settings.If you scroll the threads you’ll find examples of mapping sensors like VOC to the display worked great for me