Component reference · stat · Garden Handbook

1Examples

Code

```garden stat
items:
  - label: Reading Column
    value: "740"
    unit: px
    caption: Default prose column width
  - label: Wide Figure Limit
    value: "1040"
    unit: px
    caption: Extends up to 150px on each side
  - label: Wide Table Limit
    value: "1340"
    unit: px
    caption: Extends up to 300px on each side
```

Preview

Reading Column

740px

Default prose column width

Wide Figure Limit

1040px

Extends up to 150px on each side

Wide Table Limit

1340px

Extends up to 300px on each side

2Syntax

```garden stat
items:        # for several, 2–4 suggested
  - label:    # required, label
    value:    # required, number
    unit:     # optional, unit
    caption:  # optional, short note
    text:     # optional, extra text
    source:   # optional, source URL
```

Fence header: ```garden stat (snippet trigger ;gstat). Place multiple figures in items, or place fields at the top level for a single figure; invalid YAML or unknown top-level keys report garden-yaml on the block.

Field	Required	Default	Allowed Values & Limits	Description
`items`	Required for multiple figures	`[top-level object]`	object[] (`2` to `4` items recommended, not checked)	List of stat items displayed side by side; when omitted, top-level fields render as a single stat item
`label`	Required	`""`	string	Metric name shown above the number
`value`	Required	`""`	string or number	Primary figure rendered in large tabular type
`unit`	Optional	none	string	Unit shown immediately to the right of `value`
`caption`	Optional	none	string	Short note below the figure
`text`	Optional	none	string	Additional explanatory text
`source`	Optional	none	URL, `{ url, site?, icon? }`, or array	Source attribution chip (`site` defaults to the URL hostname without `www.`)

4Limits & errors

Apart from the shared garden-yaml, this component has no error codes of its own; values marked "not checked" in the table never report an error.

1Examples

2Syntax

3Fields

4Limits & errors