# Capacity Usage block

> Capacity usage strip of 3 divided metric cells with value over total and segmented meters

Operational capacity panel for invoices, stock and budget: each cell pairs an icon tile and caption with value of total, a derived percent, a 40 bar meter and an actions menu. ReUI Frame, IconTile; shadcn DropdownMenu, Button. Ops dashboards.

- Type: Pro block
- Category: [Stats](https://reui.io/blocks/application/stats.md)
- Page: https://reui.io/blocks/application/stats/stats-18
- MCP: `get_block("stats-18")`
- Built with: Button, Dropdown Menu, Frame, Icon Tile
- Installs with a ReUI Pro or Ultimate license; setup: https://reui.io/docs/license-setup

## Best for

Capacity used against a total for 3 metrics, each with a percent derived from its figures, a 40 bar meter and a 4 item actions menu

## Agent notes

- Replace `CAPACITY_METRICS` in data.tsx with raw numbers; percent and meter fill derive from `value` and `total`, and `format` picks count or compact USD
- Each `DropdownMenuItem` in `MetricMenu`, from View Details to Export Data, has no handler; wire them to your own actions
- `MetricCell` and `SegmentMeter` divide by `total` unguarded, so a total of 0 prints NaN% or Infinity%

## When not to use

- A whole operations page with a capacity meter, a donut and an exception queue: use [Fulfillment Exceptions](https://reui.io/blocks/application/dashboard/dashboard-1.md) (`get_block("dashboard-1")`)
- Plain figure tiles with a label and a value but no meter under them: use [Deal Invoice Tiles](https://reui.io/blocks/application/card/card-35.md) (`get_block("card-35")`)

## Install

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

## 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://reui.io/blocks/application/card.md)
- A metric whose value carries a small trend drawn beside or under it: use the [Sparkline blocks](https://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://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://reui.io/llms.txt. Agents with the ReUI MCP (https://reui.io/docs/mcp) get the same guidance from the getters named above.