Page blocksContent

Content List

Install a typed Payload CMS content-list block with a serif heading and labeled terms. The CLI wires it into your Pages layout, renderer, types, and import map.

v0.2.0Page blockContent familyContent section

New in 0.2.0 Lists the block under the Content heading in the admin Blocks Drawer (admin.group). Needs Payload 3.25 or newer.

Installation

npx payload-components add content-list

What it installs

Copies 2 source files into your project:

  • src/blocks/ContentList/config.ts
  • src/blocks/ContentList/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 CLI install detects existing source and wiring, then records install state in .payload-components/state.json.

Content model

This serif "list" variant uses its own fields (not the shared contentFields base): a heading beside a list of labeled-term paragraphs.

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 ContentList 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-blocks-app
Payload
v3 (3.25 or newer) / v4 (experimental)
Next.js
15 / 16 with v316 (16.4 or newer) with v4
shadcn UI
badge

Payload v4 support is experimental: it needs Next.js 16 (16.4 or newer) and Node.js 24.22.1 or newer. Payload v3 (3.25 or newer) stays fully supported.

Your project must already expose components.json, src/payload.config.ts — the surfaces patched by payload-components add. The CLI verifies this against the support matrix before touching anything.

In this family

content-columns
Content ColumnsA two-column content section pairing a heading with body paragraphs and a CTA, installed as a wired Payload block.
content-image-lead
Content Image LeadA content section led by a full-width image above a two-column heading, body, and CTA.
content-feature-media
Content Feature MediaA content section pairing body copy and two icon features beside a framed media panel.
content-feature-split
Content Feature SplitA content section pairing a side media panel with body copy and two icon features.
content-showcase
Content ShowcaseA centered content section with an intro, a full-width image, and a four-up grid of icon features.
content-quote
Content QuoteA content section pairing a media panel with body copy and a cited pull quote.
content-community
Content CommunityA centered content section with a heading, body copy, and a wall of community avatars.
content-split-rows
Content Split RowsA content section with an intro and alternating media-and-text rows.
content-rows
Content RowsA content section with an intro and a uniform stack of media-and-text rows.
content-image-frame
Content Image FrameA centered content section with an intro and a layered, framed screenshot.
content-stats
Content StatsA content section with an intro, a grid of icon features, and a stats list.
content-listcurrent
Content ListA serif-headed content section pairing a heading with a labeled-term list.
content-list-columns
Content List ColumnsA serif-headed content section with a two-column labeled-term list.
content-list-icons
Content List IconsA serif-headed content section with an intro and a multi-column icon list.

Content Stats

A content section with an intro, a grid of icon features, and a stats list.

Content List Columns

A serif-headed content section with a two-column labeled-term list.