Installation

npx payload-components add feature-icon-grid

What it installs

Copies 4 source files into your project:

src/blocks/shared/featureFields.tsshared
src/blocks/shared/featureIcons.ts
src/blocks/FeatureIconGrid/config.ts
src/blocks/FeatureIconGrid/Component.tsx

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

Registers the block	`src/collections/Pages/index.ts`
Maps the renderer	`src/blocks/RenderBlocks.tsx`
Regenerates types	`src/payload-types.ts`
Regenerates the admin import map	`src/app/(payload)/admin/importMap.js`

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

featureFields.ts is the shared field core for this family — every variant composes it. Editing it updates each installed block at once, and re-running an install never overwrites a copy you have changed.

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

Content model

The first three fields come from the shared featureFields base. items and links define this icon-grid variant; required icon choices come from the shared Feature icon map.

Prop

Type

Each item in items carries:

Prop

Type

Usage

Add the block to a page. In the Payload admin, open (or create) a Page and add the FeatureIconGrid 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, card

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.

In this family

feature-bento

Feature BentoAn asymmetric bento grid that leads with a featured cell and fills supporting cells.

feature-split

Feature SplitA two-column feature section pairing a heading and CTA with a stacked feature list.

feature-steps

Feature StepsA numbered steps block for sequential, how-it-works feature flows.

feature-grid-basic

Feature Grid BasicA text-first feature grid with repeatable items, optional CTA wiring, and idempotent registration.

feature-accordion

Feature AccordionA synchronized feature accordion with editor-selected icons, optional media, and CTA links.

feature-cards-media

Feature Cards MediaA two-column feature layout with independent media, optional icons, and CTA links.

feature-icon-gridcurrent

Feature Icon GridA dense feature grid with editor-selected icons and a tokenized radial grid decorator.