Skip to content
Stand with Ukraine flag

Alarms count by severity

  • Widget
  • 13 installs
  • v1.0.0
  • Aug 17, 2026
  • MIT license
  • v4.2+
Alarms count by severity

Shows live counts of Critical, Major, Minor, Warning, and Indeterminate alarms, plus a total, as color-coded tiles.

Widget Type
  • Alarm
Category
  • Cards & Info
Use Cases
  • Smart Building
  • Smart City
  • Smart Energy
  • Air Quality Monitoring
  • Asset Tracking
  • Environment Monitoring
  • Tank Level Monitoring

Who it’s for

Anyone whose first question on opening a dashboard is “what am I actually dealing with right now?” needs this card. A dispatcher decides what to work on first, a shift lead checks what piled up overnight, and a regional manager scans one tile per site to spot where alarms are concentrating. A service company tracks the Critical count as the number their SLA lives or dies by, and a network operator watches for a rising Minor count, which often precedes a Critical one.

What it does

A site with three open Critical alarms, one Major, and nothing else shows 3 in red on the Critical tile, 1 on Major, and 4 on Total — every other severity tile still reads 0, not blank.

  • One tile each for Total, Critical, Major, Minor, Warning, and Indeterminate — a live count, a small icon, and a label, colored to match
  • Every severity tile always renders, even at zero, so a quiet site looks quiet rather than looking unconfigured
  • Total is configured exactly like every severity — its own color, label, and icon — and sits inline with them, not as a separate header element
  • Counts whatever the Data tab’s alarm source and filter match; it does not open, acknowledge, or clear alarms itself

How to set up

Alarm source and filter

SettingDefaultEffect
Alarm source (Data tab)None — must be setThe single entity or entity alias whose alarms are counted
Alarm filter — severity, status, type (Data tab)No restriction (any status, every severity and type)The only place filtering happens; the widget has no filter controls of its own

Add the widget to a dashboard state, then set the alarm source and, if you want to narrow it, the alarm filter — both live on the Data tab, the same place any alarm widget configures them. With a source bound and no filter narrowed, the card counts every open alarm on that source and shows live totals for Total and all five severities right away, using the default colors, icons, and labels.

How to customize

  • To change how a severity or Total looks — set its Show, Label, Color, and Icon under Settings → Alarm counts. Each is its own group, so changing Critical never affects Major, and hiding one tile never affects the others’ layout.
  • To hide all icons at once — turn off Show icons under Settings → Display.
  • To make tile backgrounds stronger or more subtle — adjust Tile background tint opacity (0-1) under Settings → Display; each tile’s color is used at this opacity for the background, while the count, label, and icon stay at full solid color.
  • To restyle the text — adjust Label font and Count font under Settings → Display.

Tips

  • Turn off Show for a severity you don’t track — Indeterminate, most often — instead of leaving its tile at a permanent zero.
  • Because filtering lives on the Data tab, editing the alarm filter later updates this same widget instance automatically; there is nothing to touch in its own settings.
  • For a per-site view, give each site’s dashboard state its own alarm source (entity or alias); the widget always shows one shared count set for whatever source is bound, not a breakdown across several.

Share Your Widget with the Community

Built a custom widget? Export it as a JSON from ThingsBoard and publish it to the IoT Hub through a simple 4-step wizard (Upload, Listing, Readme, Review & Submit). Share it with thousands of ThingsBoard developers worldwide and get featured in the catalog.