Skip to content
Stand with Ukraine flag

Alarm count

  • Widget
  • v1.0.0
  • Sep 1, 2026
  • MIT license
  • v4.2+ | Built-in
Alarm count

Displays the number of alarms based on the selected filter.

Widget Type
  • Latest
Category
  • Cards & Info
Use Cases
  • Industrial Automation
  • Smart Building
  • Predictive Maintenance

Who it’s for

Operators and shift leads who need to know how much is wrong right now, before they look at what is wrong. The tile sits at the top of an operations dashboard and answers one question — is the alarm load normal for this time of day, or has something changed — with the alarm table underneath supplying the detail.

What it does

The Alarm count card counts the alarms matching a filter and prints the total with a caption and an icon. With the default filter of active alarms, a site holding three unresolved faults shows a warning icon on a teal badge, the caption Total, and 3 beside it; when the count climbs, the badge color can climb with it.

  • The filter defines the number — alarm status, severity, type and assignee all narrow what is counted, so one dashboard can carry a Critical tile next to an Assigned to me tile fed by the same entities.
  • The icon badge can react to the count — its color accepts ranges, which turns the tile into a signal that changes at a threshold rather than a number someone has to read and judge.
  • Column or row layout puts the caption above or beside the number, so the tile works in a narrow sidebar or a wide header band.
  • An optional chevron marks the tile as clickable, so the count leads to the alarm list it summarizes.
  • Caption, value and icon each take their own font and color.
  • The Alarm count card reports a total: it names no alarm, shows no severity breakdown and lists nothing, so it belongs above an alarm table rather than instead of one.

How to set up

Data keys

The Alarm count card takes no data keys — it counts alarms rather than reading telemetry.

KeyRoleTypeDescription
No key is readEntity fieldWhat the card counts comes from the datasource’s entity alias and its alarm filter. The alias picks the entities whose alarms are in scope; the filter narrows those alarms by status, severity, type and assignee.

Alarm filter

SettingDefaultEffect
StatusACTIVEWhich alarm states count — active, acknowledged, cleared, or a combination
SeverityUnsetRestricts the count to chosen severities; unset counts all
Alarm typeUnsetRestricts the count to named alarm types
Assigned to current userOffCounts only alarms assigned to whoever is viewing the dashboard

Set the alias first, then the filter, and check the number against the alarm table fed by the same alias. A tile counting every status is a different measurement from one counting only active alarms, and the caption is the only thing on the card that says which.

How to customize

  • To put the caption beside the number instead of above it — set Layout to Row; Column stacks them.
  • To keep the tile proportional at any size — leave Auto scale on; turn it off to pin exact font sizes.
  • To say what is being counted — turn on Label and replace the default Total, which describes nothing on a dashboard holding several count tiles.
  • To make the badge change color as alarms accumulate — set Icon background color to a range, so the tile shifts from calm to urgent on its own.
  • To change the symbol — set Icon to any Material or MDI name and adjust its size and color; the badge behind it has its own size.
  • To make the number itself react — set Value color to a range instead of a constant.
  • To mark the tile as clickable — turn on Chevron and attach a click action opening the matching alarm list.

Tips

  • Pair a wide All active tile with narrow Critical and Major tiles fed by the same alias. The totals then decompose at a glance, and a rising critical count is visible even while the overall total stays flat.
  • Put the threshold in the badge color rather than expecting anyone to judge the number. Whether 12 is normal depends on the site, and encoding that judgement once in a color range beats re-explaining it to every new operator.

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.