# Analytics Overview block

> Three-column KPI stat cards with icon tiles, trend badges, and date range footer

Responsive 1 to 3 column metric grid; each card pairs a colored icon tile with a value, label, up/down trend Badge, and reporting date range. ReUI Frame, Badge, shadcn Item. For dashboards, analytics overview, KPI summary.

- Type: Pro block
- Category: [Stats](https://web.dev.reui.io/blocks/application/stats.md)
- Page: https://web.dev.reui.io/blocks/application/stats/stats-8
- MCP: `get_block("stats-8")`
- Built with: Badge, Frame, Item
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

Tiles led by a colored icon tile with the trend badge across from it, each closing on its reporting date range

## Agent notes

- Each `cards` entry in data.tsx carries `icon`, `iconColor`, `badge` and `dateRange`; swap the 3 samples and keep the type
- The trend `badge` color, icon and text are typed by hand per `cards` entry, so a change of sign means editing those 3 fields together
- `dateRange` is a literal string on every card, and `value` is a number shown through `toLocaleString`

## When not to use

- Metric rows stacked in one headerless stack, each with an open details arrow: use [Order KPI List](https://web.dev.reui.io/blocks/application/list/list-1.md) (`get_block("list-1")`)
- Metric tiles that each carry an actions menu with Edit and Delete: use [Logistics KPI Tiles](https://web.dev.reui.io/blocks/application/card/card-30.md) (`get_block("card-30")`)

## Install

```bash
npx shadcn@latest add @reui/stats-8
```

## About Stats blocks

### When to use

- A row of 3 or 4 KPI tiles to sit above the content of a page you already have
- One metric card that pairs a headline figure with a meter, a split bar or supporting rows
- A card already written for one topic: leads, tasks, quota, compliance, renewals, adoption, balance or capacity

### When not to use

- Tiles on a dotted, halftone or line grid backdrop, or records such as profiles or jobs: use the [Card blocks](https://web.dev.reui.io/blocks/application/card.md)
- A metric whose value carries a small trend drawn beside or under it: use the [Sparkline blocks](https://web.dev.reui.io/blocks/chart/sparkline.md)
- A whole overview page with a header, summary tiles and a work list or trend under them: use the [Dashboard blocks](https://web.dev.reui.io/blocks/application/dashboard.md)

### Agent notes

- Each page.tsx only centers `Stats` in a padded wrapper; mount `Stats` from components/stats.tsx inside your own layout
- `Stats` takes no props, fetches nothing and wires no handler, so add props for your own figures and callbacks

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.