Flooding level progress bar

Who it’s for

City operators and water management engineers monitoring rivers, drainage channels, or flood sensors ask “how high is the water relative to the danger level, at a glance?” A fill-style bar makes it immediately obvious how close the level is to a threshold, without reading a number.

What it does

A sensor reading 0.3 m fills the bar to 6% of its 5 m scale in blue — Normal. At 1.8 m the bar fills to 36% and turns orange — Warning. Above 3 m the fill turns red — Critical.

• Horizontal progress bar that fills left to right as the water level rises, scaled from 0 to 5 m by default
• Color-coded fill that changes across three flood severity segments: blue for Normal, orange for Warning, red for Critical
• Numeric value and label displayed alongside the bar
• Last-updated timestamp showing how long ago the reading arrived
• Shows one sensor’s data; it does not chart history or compare multiple locations

How to set up

Data keys

Key	Role	Type	Description
flooding	Bar value	Timeseries	Water level in meters; change the key name to match your device’s telemetry key

The widget ships with a simulated function datasource key labeled Flooding level, 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.

If the key has never reported, the bar renders empty.

Value ranges

Range (m)	Level	Color
0–1	Normal	Blue
1–3	Warning	Orange
3+	Critical	Red

How to customize

• To change the bar scale — set Tick min and Tick max to match the physical range of your sensor or channel (e.g. 0 to 10 m for a deep river).
• To use your own flood thresholds — edit the Color ranges; the bar segments shift automatically.
• To change the unit label — set Units to your preferred label (e.g. ft for feet).
• To hide the value or timestamp — turn off Show value or Show date.
• To match your dashboard’s fonts — set the font options in the widget settings.

Tips

• Set Tick max to the physical capacity of the channel or containment area, not just the Critical threshold. The bar then shows how close to absolute maximum the level is, not just how close to the alert boundary.
• Align the color segment boundaries with your local flood authority’s official alert levels so the bar matches the alerts your team already responds to.