Overview
The Gauge field type (gauge) provides a read-only visual representation of a numeric value, typically displayed as a progress bar or circular gauge. It is used to present completion percentages, scores, or other metrics in a visually engaging way.
Properties
| Property | Required | Description |
|---|---|---|
| ID | Yes | The field identifier. |
| Type | Yes | Must be set to gauge |
| Name | Yes | The display label. |
| Width | No | The percentage width. |
| Help | No | Tooltip text. |
| Visibility | No | A condition controlling visibility. |
Key Characteristics
- Read-only — the gauge always displays a value but cannot be directly edited. The underlying value is set by other means (calculations, formulas, or automated processes).
- Visual — the gauge provides at-a-glance understanding of a value through colour and shape
- Proportional — the visual fill represents the value as a proportion of the total range
Use Cases
- Completion percentage — showing how far along a project or task is
- Score display — visualising assessment or risk scores
- Capacity utilisation — showing resource usage as a percentage
- Target progress — displaying progress toward a KPI or target