When to use it. A compact indicator that displays state as a colored dot or badge. The color changes based on synced state values mapped through statusColors.
Type
statusLight
Also titled
Status Light
Default size
1 row × 1 column
Symbol
circle.fill
Docs
Docs complete
Search for it as
led
indicator
status
health
up down
traffic light
Rendered by the app
Fields
8 fields you can set on a statusLight control. Every control also takes the shared fields (id, position, span, sync, action).
Fields
Field
Type
Default
What it does
Titlelabel
text
—
The name shown next to the light
Shows this text beside the dot in the label font size (8-24 pt, default 12).
Colortint
color
#34C759
The light's color when no state color applies
Colors the dot or badge and its glow in this color until a state with its own color in statusColors is received.
Colors for each statusstatusColors
object
—
Which color each status shows
Recolors the light to the color matching the current state text; a state with no entry keeps the tint color.
Sizesize
choiceone of 3
default
How big the light is drawn
Sets the dot diameter to 8, 12 or 18 points; the badge style scales with it.
smalla tiny 8 pt dot for dense rows
defaultdefaulta standard 12 pt dot
largea bold 18 pt dot you can read across the room
Shapestyle
choiceone of 2
dot
Plain dot or a pill with words
Switches between a round dot beside the label and a capsule that spells out the current state in text.
dotdefaulta round colored light with the label beside it
badgea rounded pill that shows the state name in its tint
Glowglow
number0–1step 0.05
0.3
A soft halo around the light
Sets the halo strength from 0 (flat) to 1 (full); in the badge shape it sets how strongly the pill is tinted.
Pulsepulse
on / off
false(off)
Whether the light breathes
Makes the light fade in and out continuously while true; false keeps it steady.
Starting statusdefaultValue
text
—
The status shown before any update arrives
Picks which statusColors entry the light shows at first, until a synced value or a live update replaces it.
Emits and receives
What this control sends when you use it, and what it can show or follow when data arrives.
Receives
Receives
Takes
From
Type
What it does
valueshow
hub, mqtt, http, sensor, store, derive, default
string
a state word such as online, degraded or offline
the light takes the color listed for that word in the status colors (or its own color when the word is not listed), and the badge shape spells the word out
Example: online
Sample
The placeholder value the editor shows before real data arrives.
online then offline
Examples
6 examples, each one a control you can paste into a layout.
Shows a live binding: the server broadcasts {"msg_type": "server_health", "state": "degraded"} and state picks the statusColors key, so the badge turns amber and pulses.
The status light has no tap, long-press or detail action; it only displays state. Every hinted editor field (Title, Color, Size, Shape, Glow, Pulse) changes something visible on screen.