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.
Settings
| Field | What it does |
|---|---|
| Entity | The value to display |
| Size | Small (150px) or Large (300px) |
| Gauge label | Wording shown with the dial |
| Units | Suffix for the number, e.g. °C, %, V |
| Min | Value at the start of the dial |
| Max | Value at the end of the dial |
| Color | The dial colour |
| Admin only | Hide 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?”.