# Stats Grid

> Render numerical stats in a responsive grid.

Canonical HTML: https://press.varavel.com/docs/shortcodes/stats-grid/
Markdown: https://press.varavel.com/docs/shortcodes/stats-grid/index.md

`stats_grid` renders key numbers with labels and optional descriptions.

## When to Use

Use it when numbers provide real proof: performance, adoption, reliability, coverage, or time saved. Avoid vanity metrics that do not help the visitor decide.

## Usage

```markdown
{{/* stats_grid(
stat_1_value="10x",
stat_1_label="Faster launches"
) */}}
```

## Live Example

{{ stats_grid(
container="md",
title="Built for static speed",
stat_1_value="0",
stat_1_label="runtime server",
stat_2_value="20",
stat_2_label="shortcodes",
stat_3_value="1",
stat_3_label="breakpoint"
) }}

## Parameters

| Parameter      | Description                                  |
| -------------- | -------------------------------------------- |
| `container`    | Inner content width for the stats section.   |
| `eyebrow`      | Small uppercase label above the heading.     |
| `title`        | Section heading.                             |
| `description`  | Supporting copy below the heading.           |
| `columns`      | Desktop column count. Use `2`, `3`, or `4`.  |
| `stat_N_value` | Main numeric value for stat `N`.             |
| `stat_N_label` | Label for stat `N`.                          |
| `stat_N_desc`  | Optional description for stat `N`.           |
| `bg`           | Full-width section background token.         |
| `class`        | Additional CSS classes on the outer section. |