> ## 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.

# Indicator

> A compact state indicator (dot / badge) driven by a bound value.

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

## Mental model

An **Indicator is a warning light.** A small dot or badge that changes color with a
value — the most compact way to show "good / bad / active."

## When to use it

* A tiny status marker next to a device or reading
* Space-constrained state display

## Settings

### General / Data

* **Widget Title / ID** · bind to a value or field path

### Style

State colors, size, shape — set how each state looks.

## Example

```cpp theme={null}
device.updateWidget(targetId, "linkDot", String(online ? "on" : "off"));
```

## Script API example

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

```js theme={null}
ws.onMessage((msg) => {
  if (msg.link !== undefined) widget.setValue('linkDot', msg.link ? 'on' : 'off');
});
```

<Card title="Status" icon="signal" href="/dashboard/widgets/status">
  A larger status display with a label.
</Card>