# Stats

> Headline numbers in a row or as cards.

URL: https://apogee.avaui.dev/docs/sections/stats
Last updated: 2026-10-15

Headline numbers in a row or as cards.

Last updated October 15, 2026

```astro
<Stats heading="By the numbers" items={[{ value, label, description? }, …]} />
```

## Add

```sh
npx @ava-ui/apogee add stats
```

## API

| Prop | Type | Default | Category | Description |
| --- | --- | --- | --- | --- |
| `eyebrow`, `heading`, `description` | `string` | — | content | Section header (optional). |
| `items` | `{ value: string, label: string, description?: string }[]` | — | content | Required. Up to four per row. |
| `label` | `string` | English | content | Landmark name when there is no heading. |
| `layout` | `'row' \| 'cards'` | `'row'` | layout |  |
| `align` | `'start' \| 'center'` | `'start'` | layout |  |
| `background`, `spacing`, `headingLevel`, `id` |  |  | layout | As on every section. |

## Layouts

```astro
<Stats layout="cards" align="center" items={…} />
<Stats background="primary" items={…} />
```

## Accessibility

-   Numbers use tabular figures; each stat is a value and a label in reading order.