Skip to main content
Category: Display · Reads data: yes · Sends commands: no

​
Mental model

A Status widget is a status light. It reads a value and shows a state — online / offline, ok / warning / error — using color and label. A glanceable “is this good?”

​
When to use it

  • Show a device’s state at a glance
  • Reflect a computed status (ok / warning / critical)

​
Settings

​
General

  • Widget Title / ID

​
Style

State coloring, label, container — configure how each state looks.

​
Data

Bind to a value or field path in the Data tab, or push to its widget ID from firmware.

​
Example — push a status from firmware

device.updateWidget(targetId, "pumpStatus", String("ok"));   // or "warning" / "error"

​
Script API example

The same interactions from a dashboard script: 
ws.onMessage((msg) => {
  if (msg.online !== undefined) {
    widget.setValue('pumpStatus', msg.online ? 'ok' : 'error');
  }
});

Indicator

A more compact dot/badge state indicator.