Components Evidence
stats
Evidence Stack Structure
Row of 3–5 stat tiles, each with a big number and a label.
Use for at-a-glance metric rows — quarterly results, headline KPIs. Each tile reads as Big Number + caption.
When to use
- Three to five headline metrics. Quarterly results, pilot outcomes, year-end summary — anywhere a small set of independent numbers tells the story together. Each tile reads as a
big-numberin miniature. - Numbers are the headline. Lead with the number, follow with a one-line caption. The tile is for the metric and a label, not for explanation; if the caption wants a sentence, use
kpiorsplit-panel metricinstead. - Independent metrics, not parts of a whole. Stats rows are for headline KPIs that don't sum to anything — close rate, recall rate, dollars saved, days cut. For part-to-whole breakdowns reach for
piechart.
When not to use
- Six or more tiles. Past five tiles the row compresses and the numbers shrink below boardroom legibility. Split into two rows or move to
kpiwhere the dashboard grid gives each metric its own card. - Tiles with no number. If a tile is mostly prose with a small number, the visual hierarchy inverts and the row reads as a list. Stats is for bold-number + caption — anything more belongs in
cards-grid. - Status framing without pills. If each metric needs a target, a trend, and a status indicator, you're authoring a dashboard, not a stats row. Move to
kpi, which carries that vocabulary.
Slots
| Slot | Selector | Required | Description |
|---|---|---|---|
title | h2 | yes | Slide heading framing the metrics. |
subtitle | p > code | no | Optional subtitle (inline-code paragraph after h2). |
tiles | ol > li | yes | One li per stat tile, authored as an ordered list (1.). The lead is the number (it renders in display type automatically — no … needed); the caption is a nested bullet beneath it:
1. 73%
- faster close
A bare number with no nested caption won't render as the big number. |
Anatomy
┌─────────────────────────────────────────┐
│ header │
│ Stats row heading │
│ │
│ 42× 87% 3.2k │
│ growth uptake users │
│ │
│ │
│ footer 1/19 │
└─────────────────────────────────────────┘