Count Widget
A single large number: how many devices or gateways currently match a condition. Use it for at-a-glance KPIs like "offline devices", "devices alerting right now", "sensors above a threshold", or "gateways online at Site A".
What it shows
One number, refreshed every 30 seconds, on a colored tile with an optional icon and an "Updated" footer. When the count is above zero, an info chip in the corner opens a drill-down listing exactly the items behind the number.
The widget reads as a sentence: of a population (which items are eligible), count the ones matching a condition (when an item counts). The Filters tab shows this sentence live as you configure it, so there is never a mystery about what the number means.
Configuring a Count widget
Basics tab
| Field | What it does |
|---|---|
| Title | Header text (required, max 120 chars). |
| Count | What the widget counts: Devices or Gateways. |
| Background color | Tile color. Defaults per type (and red for alert-driven conditions); reset anytime. |
| Icon | Optional icon from the shared icon set. |
Filters tab: which items
These narrow the population. They combine (a site filter AND a profile filter means both must match). All are optional; leave everything empty to count the whole fleet visible to the dashboard's audience.
| Filter | Applies to | Notes |
|---|---|---|
| Site | Devices + gateways | Only shown when the account's plan includes multi-site. |
| Network | Devices + gateways | Only shown when the account's plan includes networks. |
| Device profile | Devices | Also unlocks that profile's fields for the field condition below. |
| Specific devices / gateways | Both | Hand-pick up to 50 items by name, EUI, or serial. A hand-picked list replaces the other filters above - it IS the population. |
Counts always cover assigned items only, scoped to the viewer: a sub-account user sees counts for their own workspace, a partner-scope dashboard counts across the whole partner.
If a saved filter points at a site or network that was later deleted (or whose feature was turned off), the drawer shows a warning with a one-click clear, and the readback sentence says so instead of silently counting zero.
Filters tab: count when
A single condition - pick one:
| Condition | Meaning |
|---|---|
| All | Every item in the population. |
| Online | Last uplink within the device's own offline threshold (gateways: stats within 30 minutes). |
| Offline | The opposite, including never-seen items. |
| Alerting (devices) | Has an active alert; optionally pinned to one level (Info / Warning / Alert). |
| Needs attention (devices) | Offline OR alerting at any level - the "something is wrong" number. |
| Field condition (devices) | The latest reading for a chosen field meets a comparison, e.g. Temperature > 30. |
Gateways support All / Online / Offline (there is no gateway alert state).
Field conditions
The available fields follow the population:
- Universal signal fields (Signal Quality, RSSI, SNR) and Battery are always available, for any population. "Count devices with signal quality below 50%" works across the whole fleet.
- Semantic fields (Temperature (°F), Humidity (%), and the rest of the list in Semantic fields) are always offered too. Each device is compared against the field its own profile tagged with that semantic; a device whose profile has no tag never counts.
- Profile fields appear when the population is pinned to one device profile - either through the Device profile filter, or when every hand-picked device shares the same profile. Mixed-profile selections fall back to the universal fields, because a "temperature" on two different profiles is not necessarily the same measurement unless both are tagged with the same semantic.
Values are compared against each device's latest reading with its calibrations and mappings applied - the same value the rest of the platform shows.
Widgets saved before this redesign
Older Count widgets could combine connectivity and alert level at once. Those keep counting exactly what they used to (shown as Saved combo in the drawer). Picking any condition replaces the combo; it cannot be re-created.
Appearance tab
Hide the header, hide the card background (tile floats on the dashboard), and toggle the "Updated" footer.
Drill-down
Click the info chip on the tile to list the items behind the number (up to 100). The list is produced by the same query as the count itself, so it always matches the tile. Devices link to their device page; alert-driven counts show each device's alert state, and "Needs attention" shows both connectivity and alert state.
Tips
- Pair a green "Online" count, a red "Needs attention" count, and a neutral "All" count in a row for a quick fleet health header.
- Two identically configured Count widgets share one request, so duplicating a tile across tabs costs nothing extra.
- The count is a live state, not a history. For how a state evolved over time, use the State Timeline Widget.