Alarm Status Indicator

Who it’s for

For anyone building a dashboard around a zone, room, machine, or fleet who needs one fast answer to “is everything OK right now?” — shift supervisors watching a wall display, a facility engineer checking a specific room, a technician glancing at their phone before heading to a site, or an executive scanning a grid of tiles across many locations at once — without reading through a table of individual alarms.

What it does

Reads the active alarms matched by whatever alarm source and alarm filter are configured on the widget’s Data tab, finds the single highest severity among them, and renders one large tile that:

• Shows the highest active severity (Critical, Major, Minor, Warning, or Indeterminate) as a color-tinted tile with a matching icon and label.
• Shows a live count of how many active alarms currently match the filter.
• Falls back to a calm “Normal” tile — not an empty or error-looking screen — the moment zero alarms match the filter.
• Distinguishes “no alarm source bound yet” from “bound, but nothing has loaded yet” from “bound, and there’s genuinely nothing active.”

All five severities are always treated equally: none of them fall back to a shared color or get lost in a catch-all bucket.

How to set up

1. Add Alarm Status Indicator to a dashboard state.
2. On the widget’s Data tab, assign an alarm source: a single entity, or an entity alias covering a group (a room, a fleet, a building floor).
3. In the alarm filter section of that same Data tab, choose which severities, statuses, and alarm types should count — this is the only place filtering happens; the widget has no filter controls of its own.
4. That’s it — the widget shows the current alarm state automatically using sensible defaults for all five severity colors and the Normal state.

How to customize

• To change how a severity looks — set its Color, Label, and Icon under Settings → Severity appearance (one identical group per severity, so changing Critical doesn’t affect how Major looks).
• To change the “all clear” look — set Color, Label, and Icon under Settings → Normal state.
• To hide the severity icon — turn off Show severity icon under Settings → Display.
• To hide the alarm count — turn off Show active alarm count under Settings → Display.
• To make the tile background stronger or more subtle — adjust Background tint opacity (0–1) under Settings → Display; the active severity/normal color is used at this opacity for the background, while the icon, label, and count stay at full solid color.
• To restyle the text — adjust Label font and Count font under Settings → Display.

Notes

• No telemetry or attribute keys are read — the widget is driven entirely by ThingsBoard’s own alarm subscription, so there’s nothing to wire up beyond the Data tab’s alarm source and filter.
• Because filtering lives on the Data tab, the same widget instance updates automatically if the alarm filter is changed later — no need to touch widget settings to change which alarms it watches.