Gauge

Gauge

Shows one number as a dial. Best for a value with a meaningful range where you care about where in that range it sits — a tank level, a battery percentage, a temperature against its limits.

Live preview · sample data

Settings

FieldWhat it does
EntityThe value to display
SizeSmall (150px) or Large (300px)
Gauge labelWording shown with the dial
UnitsSuffix for the number, e.g. °C, %, V
MinValue at the start of the dial
MaxValue at the end of the dial
ColorThe dial colour
Admin onlyHide it from everyone who isn’t an admin of the device — see Sharing a device

Setting the range

Min and max are what make a gauge worth using — they’re the context the number sits in. Set them to the range that actually matters for the reading, not the range the sensor can technically produce.

A room thermometer set 0–100 °C spends its life barely moving. Set 15–30 °C and the same readings become easy to judge at a glance.

Values outside the range don’t break anything, they simply sit at one end, so leave a little headroom if a reading occasionally overshoots.

Gauge or text?

A Text element is better when you want to read the exact number, and when there’s no natural range for it. A gauge is better when the question is “is this normal?” rather than “what is it?”.