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

# Label

> A text label or live value readout — the most style-rich display widget.

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

## Mental model

A **Label is a nameplate — or a digital readout.** Use it for static text (a title,
a caption) or to show a live value pushed from a device. It's the most heavily
styleable widget, with full typography and effects.

## When to use it

* Titles, captions, and static text
* A simple live value readout (`27.4 °C`)

## Settings

### General / Data

* **Widget Title / ID** · text or bound value

### Style

The richest style set: **angle**, **animation / animation type**, **backdrop
filter**, **blur**, **blend mode**, **box shadow**, border (color / width / radius /
style), background, and full typography.

### Triggers

`click`, `hover`, plus the common lifecycle events.

## Example — live readout from firmware

```cpp theme={null}
device.updateWidget(targetId, "tempLabel", String(temperature) + " °C");
```

## Script API example

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

```js theme={null}
// Live clock
setInterval(() => {
  widget.setText('clock-label', new Date().toLocaleTimeString());
}, 1000);
```

<Card title="Status" icon="signal" href="/dashboard/widgets/status">
  For a colored state instead of plain text.
</Card>