Widget

Gauge

A single numeric reading shown as a graphic — a ring, an arc, a needle dial, a bar, a thermometer, a tank, a battery, and more. Point it at any sensor with a number and pick the look. Color zones let the gauge change color as the value crosses thresholds.

What it does

The gauge reads the numeric state of one entity and draws it against a min and max you set. The fill, ring, or needle moves to show where the value sits in that range, and the number is printed in the center with its unit. If the entity has no value or is unavailable, the gauge shows — rather than a misleading 0.

The bar position never lies under unit conversion The fill fraction is computed from the raw value against min/max; only the printed number and unit are converted for display, so min and max stay in the unit you authored them in.

Styles

Ten looks, all driven by the same value. Pick one in the inspector:

Style	What it looks like
Arc	The default. A 270° open arc with the value and unit in the center.
Ring	A full closed circle that fills clockwise; value in the center.
Needle dial	A classic dial with a pointer that swings across a 270° track.
Linear bar	A horizontal capsule that fills left to right, value above it.
Bullet	A Stephen-Few bullet bar — a thin value bar over grayscale qualitative bands with a comparative target marker.
Segmented	A row of twelve cells that light up in proportion to the value.
Thermometer	A skeuomorphic tube and bulb that fills from the bottom, value beside it.
Tank / fill	A rounded tank that fills from the bottom; value in the center.
Battery	A battery outline that fills left to right; turns red at or below 20%.
Digital	Just the number, large, in the value color, with the title above.

Add it

Enter edit mode, tap Add Widget, choose Gauge.
Bind the widget to the entity whose number you want to show (a temperature, humidity, power, percentage, etc.).
Open the widget's inspector (tap the widget while editing), pick a style, and set the min, max, and unit.
Optionally add color stops so the gauge changes color as the value rises.

Settings

Setting	What it does
Gauge style	One of the ten looks above — Arc, Ring, Needle dial, Linear bar, Bullet, Segmented, Thermometer, Tank / fill, Battery, Digital.
Color	The base color for the needle, fill, and value. Leave it to follow the page theme accent. Per-value color stops override it where they apply.
Min	The value at the empty end of the gauge. Default `0`.
Max	The value at the full end of the gauge. Default `100`.
Unit	Shown after the number (e.g. `°C`, `%`, `W`). Optional.
Color by value	Add stops — a value and a color (e.g. ≥5 red, ≥50 orange, ≥100 green). The gauge takes a stop's color at or above its value.
Blend colors (gradient)	Appears once you have more than one stop. On, the gauge blends smoothly between adjacent stop colors instead of switching in hard bands.

How color stops resolve The gauge picks the color of the highest stop at or below the current value. With gradient off you get discrete bands; with it on, the color blends between the two surrounding stops. With no stops at all, the gauge uses the base Color (or the theme accent).

The title comes from the widget The text under the value is the widget's display name. Set the label position to none on the widget and the gauge renders no title at all.

If you see "—" That means the bound entity has no numeric state right now — it's unavailable, has no value, or isn't a number. Check the entity binding rather than the gauge settings.