Metric widget
What it is
Displays a single prominent number or text value with an optional label, prefix, and suffix — designed for KPIs and at-a-glance stats.
Config fields
| Field | What it controls | Example |
|---|---|---|
| Value | The main text or number to display. Any string is accepted. | 98.7 |
| Label | Descriptive label rendered below the value. | Uptime (%) |
| Prefix | Short text prepended to the value. | $ |
| Suffix | Short text appended to the value. | % |
| Value Color | Hex colour of the value text. | #22c55e |
| Value Font Size | Size of the value text in pixels. Range 16–120. Default 48. | 64 |
| Label Font Size | Size of the label text in pixels. Range 8–48. Default 14. | 14 |
The rendered output is: [Prefix][Value][Suffix] on one line, with the label below.
Common pitfalls
- Static values only. Like the Chart widget, Metric does not poll a live data source. Update the Value field manually or via the API when the number changes.
- Very long values clip. The tile width is fixed by the grid; very long strings (e.g. a full URL) will be truncated. Keep values short or reduce the font size.
Troubleshooting
| Symptom | Try |
|---|---|
| Value overflows the tile | Reduce “Value Font Size” or shorten the value text. |
| Prefix/suffix not showing | Confirm the Prefix or Suffix fields are not empty and that the widget is saved. |
| Colour not changing | Make sure you are entering a valid hex value (e.g. #ff6600). |