Practical Payload CMS v3 guidance
Payload CMS block and installer guides
Practical Payload CMS v3 guides for installing reusable blocks, wiring collections and renderers, generating types, and fixing blocks that do not render.
Start with a proven guide
Installation guide
npx payload-components add hero-basic
Install a wired Payload block
Add a real block with the supported CLI, then review every file and wiring change that lands.
Follow the installation guideBlock wiring guide
Wire a reusable block
Follow a Payload CMS v3 block from config through registration, rendering, generated types, and the admin import map.
Read the guideTroubleshooting guide
Fix a block that will not render
Check the four places that usually explain why a saved block does not appear on the page.
Read the guideField notes from the registry
More Payload CMS field notes
Browse implementation lessons, component design notes, and release stories from the open registry.
Project notes
Templates Are Here: Six Payload Site Concepts to Explore
Foundations
What Is a Payload CMS Block?
Foundations
Build Your First Payload v3 Landing Page with Next.js
Foundations
Anatomy of a Production-Ready Payload Block Config
Foundations
How RenderBlocks Turns Payload Data into a Next.js Page
Foundations
Why Payload Types and the Admin Import Map Must Stay in Sync
Foundations
Payload Block Not Rendering? Follow This Debugging Checklist
Installer internals
Copying a Component Is Not the Same as Installing It
Installer internals
Using a shadcn Registry with Payload CMS
Installer internals
The Manifest as an Executable Wiring Contract
Installer internals
Why We Patch Source with Text Anchors Instead of Rewriting the AST
Installer internals
Designing an Idempotent Code Installer
Installer internals
Meet `payload-components doctor`
Component design
Component Variants Without Prop Explosion
Component design
Sharing Payload Fields Across a Component Family
Component design
How to Choose the Right Hero for a Payload Site
Component design
Designing Feature Sections Editors Can Actually Maintain
Component design
Modeling Pricing Pages in Payload Without Hard-Coding the Design
Component design
Building Credible Social-Proof Sections
Production guides
Build a Complete SaaS Homepage with Payload Components
Production guides
Build an Editorial Blog Frontend with Payload Post Components
Production guides
Designing an Accessible FAQ Block for Payload CMS
Production guides
Safe Links, Forms, and Embeds in CMS-Managed Components
Production guides
Making Motion Feel Good Without Sacrificing Performance
Production guides
Type-Safe Block Rendering Patterns for Payload and Next.js
Quality & community
Why Every Live Preview Has a Demo Twin
Quality & community
Visual Regression Testing a Component Registry
Quality & community
How to Add a Payload Component End to End
Quality & community
Building a Reproducible shadcn-Compatible Registry
Quality & community
Open Source Requires Provenance, Not Just a License File
Quality & community
How Real Installs Should Shape an Open-Source Component Roadmap
Project notes
Payload CMS block not showing? Check the four wiring steps
Project notes