---
title: "Stat List Module for Sanity + Next.js"
description: "Highlight key metrics and results with a stat list module: big numbers, suffixes, and supporting copy for social proof."
---

# Stat list module

Big numbers with supporting copy, displayed in a grid or a carousel. Great for metrics and social proof.

[View source on GitHub](https://github.com/nuotsu/sanitypress/tree/main/src/modules/stat-list) (schema + React component)

## Module fields

| Field | Type | Description |
| --- | --- | --- |
| `eyebrow` | string | Small label shown above the intro. |
| `intro` | Portable Text | Heading and copy, centered above the stats. |
| `stats` | array of `stat` | The stats to display. See stat fields below. |
| `layout` | `grid` \| `carousel` | Defaults to `grid`. `carousel` scrolls horizontally with scroll buttons and markers. |
| `columns` | number | Fixed column count on desktop. When empty, columns auto-fit at roughly 256px each. Hidden when `layout` is `carousel`. |
| `attributes` | `module-attributes` | Shared by every module: `uid` (HTML id for deep links), `hidden`, and `scopedCss`. |

## Stat fields

| Field | Type | Description |
| --- | --- | --- |
| `value` | string | The headline number, e.g. 100%. |
| `suffix` | string | Smaller text after the value, e.g. /100. |
| `content` | Portable Text | Supporting copy. |

## Demo: Grid layout

Four stats in the default grid. The last one uses a `suffix`.

**100%**

Lorem ipsum

**100+**

Lorem ipsum

**$100**

Lorem ipsum

**100/100**

Lorem ipsum

Frequently Asked Questions

## Stat list module FAQ

### When should I use the Stat list module?

Use it to show results at a glance: performance scores, customers served, time saved, or any metric that builds trust. Big numbers with short supporting copy work well near the top of a landing page.

### How do I add the Stat list module to a page?

In Sanity Studio, open the page, click Add item in its Modules field, and pick Stat list. Fill in the fields, check it in the live Presentation preview, and publish. Modules can be reordered by dragging, and the same module can be used on any page as many times as you need.

### How do I customize the Stat list module?

Give each stat a value (for example 100%), an optional smaller suffix (for example /100), and supporting rich text. Choose a grid or carousel layout and set a fixed column count if needed.

Every module also has a Scoped CSS field (plus a uid for deep links and a hidden toggle), so you can restyle one instance without touching the rest of the site. For bigger changes, edit the module's React component and schema in src/modules/stat-list in the repo.

Previous module

![Quote list module](https://cdn.sanity.io/images/cyu7k2r0/production/88b1f3bab5106871b5f755804ce51ff2f57520fe-2560x816.png)

[Quote list module](/modules/quote-list)

Next module

![Step list module](https://cdn.sanity.io/images/cyu7k2r0/production/310e51748a70170320f0a7043adba8aaeb9c8060-2560x848.png)

[Step list module](/modules/step-list)
