# Stats cards

> A row of metric cards for dashboards.

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

A row of metric cards for dashboards.

Last updated October 15, 2026

```astro
<StatsCards items={[{ label, value, change?, trend? }, …]} />
```

## Add

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

## API

| Prop | Type | Default | Category | Description |
| --- | --- | --- | --- | --- |
| `items` | `{ label, value, change?, trend? }[]` | — | content | `Stat` props. |
| `label` | `string` | `'Key metrics'` | content | Landmark name. |
| `layout` | `'row'` | `'row'` | layout | One to four columns by viewport. |
| `spacing` |  | `'small'` | layout |  |

## Accessibility

-   A labelled region (“Key metrics”) holding a list; numbers use tabular figures.