> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperwisor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Status

> A status indicator driven by a bound value — shows state with color.

<Info>
  **Category:** Display · **Reads data:** yes · **Sends commands:** no
</Info>

## 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](/dashboard/binding-data), or push
to its widget ID from firmware.

## Example — push a status from firmware

```cpp theme={null}
device.updateWidget(targetId, "pumpStatus", String("ok"));   // or "warning" / "error"
```

## Script API example

The same interactions from a [dashboard script](/script/overview):

```js theme={null}
ws.onMessage((msg) => {
  if (msg.online !== undefined) {
    widget.setValue('pumpStatus', msg.online ? 'ok' : 'error');
  }
});
```

<Card title="Indicator" icon="circle" href="/dashboard/widgets/indicator">
  A more compact dot/badge state indicator.
</Card>