Status Widget

A colored pill indicator. The Status widget shows a single state at a glance: connected / disconnected, OK / warning / alarm, on / off. It's compact, high-contrast, and ideal for at-a-glance dashboards where users scan many devices.

What it shows

A colored "pill" badge with a label, optional icon, and optional pulsing animation. The color and label come from one of three logic variants.

The three variants

Pick the variant when you create the widget. Each variant takes different inputs.

Connectivity

"Is this device online?" Uses the device's lastSeen timestamp, no field required.

Configurable:

• Offline threshold - the device is considered offline after this much silence. Presets: 1m, 5m, 10m, 15m, 30m, 1h, 2h, 6h, 12h, 24h (default 5m).
• Online state - label (e.g., "Online", "Connected"), color, icon.
• Offline state - label, color, icon.
• Never seen state - shown if the device hasn't reported even once. Label, color, icon.
• Show last seen subtitle - displays "2 min ago" / "3 hours ago" under the pill.

Field rules

"What state is this field in?" Reads a field's current value and matches it against rules you author.

For numeric fields, you set threshold rules:

• Operators: >, >=, <, <=, ==, between.
• Each rule: value(s), color, label, icon.
• First match wins.

For boolean or string fields, you set equality rules:

• Operators: == or !=.
• Each rule: value (string), color, label, icon.
• First match wins.

Always set a Fallback state for "no rule matched" (label, color, icon).

Alert state

"Is this device currently in alert state from a rule?" Reads the device's rule-driven alert level set by a workflow's set-device-status action. See Responding to alerts -> Alert states on a device.

Configurable:

• OK state - label, color, icon. Shown when no alert is active.
• Info state - label, color, icon.
• Warning state - label, color, icon.
• Alert state - label, color, icon (typically high-contrast red).
• Show Acknowledge button - when on and an active alert is shown, viewers who may act (Operator and above) get a button that clears the device's alarm for everyone; the widget records and briefly shows who acknowledged. It does not mark inbox notifications read. While an acknowledge is still pausing a workflow's notifications, the same slot shows "Notifications paused: acknowledged by ..." with a Resume notifications button to undo it.

Configuring a Status widget

Basics tab

Field	What it does
Title	Header text (required, max 120 chars).
Source variant	Connectivity / Field rules / Alert state. Drives which other tabs appear.

Field tab (Field rules variant only)

Field	What it does
Device	Bound device. Implicit on device dashboards.
Field	Pick the field. Type determines whether you set threshold or equality rules.

Connectivity tab (Connectivity variant only)

Set the offline threshold, the three state styles (online, offline, never seen), and the "show last seen subtitle" toggle.

Rules tab (Field rules variant only)

Add threshold rules (numeric) or equality rules (boolean / string) in priority order. Define the Fallback state.

Alert tab (Alert state variant only)

Set the four state styles (OK / Info / Warning / Alert) and the Acknowledge button toggle.

Appearance tab (all variants)

Field	What it does
Pill style	filled (solid background), outlined (border only), dot (small dot + text), alarm (oversized, high-visibility, pulsing).
Pill size	small, medium, large. Disabled when alarm style is selected (alarm is always large).
Show icon	Render the configured icon next to the label.
Show subtitle	Show the subtitle line ("last seen 2m ago" for Connectivity, etc.).
Hide header	Strip the widget title; the pill takes the full card. Useful for an "always visible" SOS-style indicator.
Hide background	Remove the widget's card chrome entirely. The pill floats over the dashboard.

Pulsing behavior

Pulses indicate "something is actively happening":

• Connectivity variant: never pulses. Offline is informational, not an active alert.
• Field rules variant: pulses when a non-fallback rule matches.
• Alert state variant: pulses when level is warning or alert.

The alarm pill style adds a more aggressive oversize layout regardless of pulsing.

Tips

• For a sub-account customer dashboard, use one Connectivity widget per critical device. Customers see "your device is online" at a glance.
• For "this temperature is OK / warm / hot" displays, use the Field rules variant with threshold rules. Status is more compact than a Value widget with thresholds.
• The Alert state variant is the right tool when a rule has set a device alert. Pair it with rules using the set_alert_status action.
• Use Hide background + alarm pill style for emergency-style indicators that need to scream.
• Set distinct icons for each state. Visually-distinct icons help colorblind users distinguish states without relying on color alone.

When to use a different widget

• For showing the actual number (with optional color rules) -> Value widget.
• For showing position within a range -> Gauge widget.
• For a list of recent state changes -> History widget.