Indoor illuminance progress bar

Who it’s for

Facility managers, building automation engineers, and workplace managers ask “where does the current light level sit on the scale from dark to glare-risk bright?” The progress bar format makes it easy to see not just which band the reading falls in, but how far it is from the recommended task-lighting zone.

What it does

A sensor reporting illuminance = 350 lx displays the value as a horizontal bar that fills proportionally from 0 to 1000 lx, with color-coded segments: dark gray for Dim (0–100 lx), orange for Low (100–300 lx), dark orange for Moderate (300–500 lx), and red for Bright (above 500 lx).

• Progress bar visualization shows where the current value sits within the full illuminance range
• Color-coded segments highlight the four bands along the bar
• Shows one sensor’s reading per widget; add multiple widgets to monitor different zones

How to set up

Data keys

Key	Role	Type	Description
illuminance	Bar value	Timeseries	Illuminance in lx; change the key name to match your device’s telemetry key

The widget ships with a simulated function datasource key labeled Illuminance, 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 (lx)	Level	Color
0–100	Dim	Dark Gray
100–300	Low	Orange
300–500	Moderate	Dark Orange
500+	Bright	Red

How to customize

• To change the bar range — open the widget settings and adjust the minimum and maximum tick values (default 0–1000 lx).
• To change the band thresholds — adjust the boundaries to match your space’s lighting standard.
• To change the segment colors — edit the color for each band in the widget settings.

Tips

• The bar format makes it immediately clear that 280 lx is near the top of the Low band — almost adequate for office work — whereas 50 lx is deep in the Dim band and clearly insufficient.
• Extend the bar maximum beyond 1000 lx if your sensors are installed in spaces with skylights or atriums that regularly exceed this level during peak sunlight hours.
• Use this widget alongside a daylight availability schedule to confirm that the lighting control system is boosting artificial light when natural light is insufficient and dimming it when natural light is sufficient.