Value cards show one number, one state or one record. They are the cards an operator glances at: the tank level, the pump state, today’s energy. This page describes each with its settings and defaults. Most of them take the source A value of a device (live), which updates as the device reports.
Colour ranges
Stat, stat with trend, gauge, progress and attributes cards share Colour ranges: up to 20 rows of From, To, Colour and Label. The first range the value falls in colours it. An empty From or To is open. A value exactly on a boundary belongs to the range that starts there (default) or the one that ends there.
Example for a cold room:
| From | To | Colour | Label |
|---|---|---|---|
| (open) | 2 | blue | Too cold |
| 2 | 6 | green | OK |
| 6 | (open) | red | Too warm |
Stat
One number with a label, an icon, colour ranges and an optional comparison.
| Setting | Values and defaults |
|---|---|
| Layout | Stacked (default), Icon left, Centred, One line |
| Scale the number to the card | On: the number grows with the card |
| Label | Up to 80 characters, under the number |
| Icon | An icon with its colour and size |
| Range colour applies to | Number (default), Icon, Card background |
| Show “Updated … ago” | Off |
Comparison. Bind the optional Compare with slot, for example the same key with Show the period just before (same length). Then set Show the change as (+12 %, +34 or Other value), An increase is (Good, Bad, Neutral: the colour of the change), Arrow and Comparison label (default “vs previous period”).
Stat with trend
The latest value of a series, with its change and a small trend line. Bind a series (usually Device readings over time (live)).
| Setting | Values and defaults |
|---|---|
| Trend line | Line shape smooth; Line width (px) 0.5 to 8 (2); Fill under the line gradient, strength 20 %; Dot on the latest point on; Mark the lowest and highest points off |
| Range colour applies to | Number, Line, Number and line |
| Change since the first point | Off, +12 % (default), +34; An increase is good, bad or neutral |
| Time span text | over 12 h (automatic), My text (for example “since Monday”), Off |
Gauge
One number on a scale with colour ranges.
| Setting | Values and defaults |
|---|---|
| Layout | Half circle, Donut (with start and end angles, default -135° and 135°), Horizontal bar, Vertical bar, Level (thermometer) |
| Minimum, Maximum | 0 and 100 (see below) |
| Show min and max | On |
| Tick marks | 0 to 21 (0 = none); Values at the ticks off |
| Show the number, Units title | On; a caption under the number such as “Temperature” |
| Needle | Off; style Line, Pointer, Notch |
| Bar colour | From the colour ranges (default) or Always the same |
| Show the ranges on the scale | Thin line beside the bar (default), Tinted track, Off |
| Animate changes | On |
Where the scale comes from. The gauge uses, in this order:
- a value bound to the Minimum or Maximum slot on the Data tab,
- the card’s own Minimum and Maximum once you set them,
- the range declared for the key in the device profile’s telemetry keys,
- 0 to 100.
A value outside the scale is marked Above the scale or Below the scale. While you customise the board, a value far off the scale shows a hint to set the scale. Gauges fade when their data is old (When data is old defaults to fading for gauges).
Progress
A number against a target.
| Setting | Values and defaults |
|---|---|
| Layout | Number and bar (default), Bar with the number beside, Ring, Half ring |
| Target | 100, or a value bound to the Target slot |
| Show | 42 of 100 (default), 42 %, 42 of 100 · 42 %, Nothing |
| Bar | Thickness (px) 2 to 48 (8); Gradient; Rounded ends |
| Ranges show as | Bar colour, Zones on the track, Both |
| Marker at | A line across the bar at a value, for example where you should be by today, with a Marker label (“Expected”) |
State
A value mapped to a labelled, coloured state: running, stopped, alarm.
| Setting | Values and defaults |
|---|---|
| Layout | Big text, Badge, Dot and label, Tinted card, Big icon, Lamp |
| States | Up to 30 rows. The first matching row wins. Match an exact value with Equals, or a range with At least and At most. Each row has a Label, Colour, Background, Icon, Pulse (for alarms) and Lit (lamp layout). |
| Otherwise | The label and icon for a value no row matches (default: the raw value) |
| Under the state | How long it has been in this state (on), The raw value (off) |
| Old data | Show “unknown” when the data is old (on), with Unknown label “Unknown” |
“Showing “OK” for a reading nobody has heard from in an hour is worse than showing nothing.” Set Data is old after (seconds) on the card’s Data tab so the state turns to Unknown when the device goes quiet.
Example for a pump that reports 0 (off), 1 (running) and 2 (fault):
| Equals | Label | Colour | Pulse |
|---|---|---|---|
0 | Stopped | grey | off |
1 | Running | green | off |
2 | Fault | red | on |
Attributes
A record as a list of labels and values, or a grid of small figures. Bind Latest values of a device as one record (up to 20 keys).
- Fields: up to 50 rows of Record key, Label, Icon and Value colour, in order. Empty shows every key of the record.
- Max rows 1 to 50 (20); Shown for an empty value “—”; lines between rows; striped rows.
Troubleshooting
| What you see | Cause |
|---|---|
| “Bind a value in this widget’s settings.” | The value slot is empty. |
| The gauge needle sits at the end | The value is off the scale. Set Minimum and Maximum, or declare the key’s range in the device profile. |
| A state card shows the raw value | No row matches. Check the exact value the device sends on its Telemetry tab, or add a range with At least and At most. |
| “stale” or “Old data” | The value is older than Data is old after (seconds). |