Documentation
Page blocksStats

Stats Proof

A proof section pairing narrative, prominent string metrics, and a semantic customer quote.

v0.1.0Page blockStats familyStats section

Installation

npx payload-components add stats-proof

What it installs

Copies 2 source files into your project:

  • src/blocks/StatsProof/config.ts
  • src/blocks/StatsProof/Component.tsx

…and makes 4 edits to wire the block into your project:

Registers the blocksrc/collections/Pages/index.ts
Maps the renderersrc/blocks/RenderBlocks.tsx
Regenerates typessrc/payload-types.ts
Regenerates the admin import mapsrc/app/(payload)/admin/importMap.js

Re-running the install converges: it detects existing wiring, skips it, and records install state in .payload-components/state.json.

Content model

This standalone Stats block keeps metric values as strings, so editors can enter percentages, signed values, counts, or abbreviated totals without formatting logic.

Prop

Type

Each item in metrics carries:

Prop

Type

Usage

Add the block to a page. In the Payload admin, open (or create) a Page and add the StatsProof block to its layout.
Fill the content. Complete the fields from the content model above — the component ships sample content you can start from.
Publish. Save and publish the page; the block renders through RenderBlocks on the frontend, fully typed — no extra wiring.

Requirements

Target
payload-website-starter
Payload
v3
Next.js
15 / 16
shadcn UI
badge

Your project must already expose components.json, src/payload.config.ts, src/blocks/RenderBlocks.tsx, src/collections/Pages/index.ts — the surfaces payload-components add patches. The CLI verifies this against the support matrix before touching anything.


Layout adapted from tailark/blocks (MIT), retokenized onto the Payload Components design system.