Payload Components

About Payload Components

Payload Components is an open-source registry of Payload CMS blocks, distributed via a CLI (npx payload-components add) rather than copy-paste. Running the install command for a given block copies the block's source files into the project and also wires it into the surrounding codebase: registering the block in the collection config, patching the render mapping file, and regenerating Payload's types and admin import map. The resulting changes are presented as a single reviewable git diff.

The registry is built for Payload CMS v3 projects using Next.js 15/16, Tailwind v4, and TypeScript in strict mode, and follows a shadcn-style registry pattern. The catalog includes page-builder blocks such as hero sections, feature grids, pricing/comparator tables, call-to-action sections, and contact forms, each defined by a field schema (eyebrow, title, description, items, links, etc.) and rendered live from source in the catalog rather than shown as screenshots. The project states it is MIT licensed and runs integration/e2e test suites plus a nightly fresh-repo install smoke test on every PR, with the underlying registry manifest exposed as JSON at /r/registry.json.

The product is intended for developers already working with Payload CMS who want to add prebuilt page blocks without manually writing the collection schema, render-mapping, and type-generation steps by hand for each one.

Key features

• CLI installs Payload CMS blocks with full wiring in one command (npx payload-components add)
• Automatically registers blocks in collection schema and render mapping files
• Regenerates Payload types and admin import map after install
• Open registry with browsable component catalog rendered from real source
• MIT licensed with integration and e2e test suites gating every PR
• Nightly fresh-repo install smoke tests against Payload 3 and Next 15/16

Frequently asked questions