Headless WordPress vs Payload CMS

All schemas are TypeScript config files, no GUI limits. Union types, custom components, and hooks all first-class.

WordPress custom post types and ACF (Advanced Custom Fields) give you significant flexibility, but content modeling requires plugin stacking rather than being native to the platform. Complex relational content and deeply nested structures need WPGraphQL plus ACF Plus plus Flexible Content layouts, workable, but fragile compared to schema-first headless platforms.

Fields and blocks are shared as named exports. Lexical blocks map cleanly to design system components.

Reusable content blocks exist via ACF Flexible Content or the block-based Gutenberg editor, but mapping them cleanly to design system components requires careful plugin configuration and custom development. There is no native concept of component-level reusability, you are adapting a publishing model into a component model.

Custom TypeScript validators are first-class, the most powerful validation system in any headless CMS.

Field-level validation is available through ACF and custom plugin code, but it is not enforced at the API layer. A determined editor can bypass most constraints. Native WordPress offers required fields but no character limits, regex validators, or custom validation rules without additional development.

Admin UI is developer-oriented. Significant customization needed before non-technical editors can work independently.

This is where WordPress earns its reputation. Millions of content editors already know the WP admin interface. Onboarding for an existing WP user is near-instant. For net-new editors, the Gutenberg block editor is reasonably intuitive and the learning curve is gentle compared to structured headless platforms.

Live preview via a configurable preview URL. Requires developer setup to connect your frontend deployment.

Live preview in a headless setup requires bespoke development. WordPress's built-in preview targets the traditional theme layer, not a decoupled frontend. Faust.js provides a preview mode, but configuring it correctly requires meaningful engineering effort and breaks if the frontend stack changes.

Drafts, versions, and autosave. Scheduling supported. Approval chains and custom stages need custom code.

Drafts, scheduled publishing, and basic role-based permissions are built in. Multi-step approval workflows require plugins (PublishPress, Nelio Content) that add maintenance overhead. Compared to platforms with native editorial workflow tooling, WordPress gets the basics right but requires plugins for anything beyond simple draft/publish.

Media collections handle uploads with basic resizing on ingest. CDN and advanced transforms need Cloudinary or S3.

The WordPress Media Library is functional and familiar. It handles uploads, basic organisation, and image cropping. At scale it becomes unwieldy, no tagging, no advanced search, folders require plugins. For a headless setup, images still need to be served from WordPress or offloaded to a CDN integration, adding configuration overhead.

No simultaneous editing. Concurrent edit locking prevents conflicts, one editor holds a document at a time.

WordPress has no native real-time collaboration. Two editors working on the same post will overwrite each other without warning in most configurations. The Gutenberg editor has basic collaborative editing in development as of 2026, but it is not production-ready for simultaneous authoring at the level competitors provide.

Access control is extremely powerful, any async function can gate any operation. Field-level access is first-class.

WordPress ships with five default roles (admin, editor, author, contributor, subscriber) and these cover most small team needs. Fine-grained permissions, by content type, taxonomy, or specific fields - require plugins like Members or User Role Editor. It is workable but not elegant.

Built-in localization supports field-level variants across all collection and global types, set in schema.

Multi-language in WordPress requires third-party plugins (WPML, Polylang, or TranslatePress). None of these are native, all add database complexity, and none offer true field-level localisation in a structured headless sense. For serious multilingual projects this is a significant limitation.

Fallback configured in Payload config and honored by Local API, REST, and GraphQL, a clean open-source implementation.

Locale fallback logic is not a native WordPress concept. WPML and Polylang have partial support, but managing fallback behaviour programmatically via the API requires custom development. This is one of the clearest gaps vs. purpose-built headless platforms.

Docs are well-written and rapidly improving. Schema-generated TypeScript types. REST and GraphQL auto-generated.

The WP REST API is well-documented and stable. WPGraphQL has strong documentation and an active community, with the v2 release in 2025-2026 adding persisted queries and federation support. TypeScript type generation works via GraphQL Code Generator. The gap vs. native headless platforms is the complexity of the underlying data model, posts, meta fields, and custom post types create a schema that reflects decades of WordPress architecture decisions rather than clean content modeling.

Runs inside your Next.js app, the deepest CMS integration possible. Astro and other framework adapters coming.

Vercel maintains an official Next.js + WordPress starter. WP Engine's Faust.js provides a more opinionated React framework for headless WordPress, though its development pace slowed in 2025-2026 as WP Engine refocused resources. Astro and Nuxt integrations exist via community packages. The ecosystem is real, but most integrations require more configuration than native headless CMS SDKs.

The Local API gives in-process data access with no HTTP overhead. REST and GraphQL cover external management.

The WP REST API supports create, read, update, and delete operations, but it is optimised for traditional editorial use - not bulk content operations, AI ingestion pipelines, or programmatic schema management. There is no concept of environment-scoped content operations or transactional batch writes native to the platform.

No built-in environment branching, staging requires a separate instance. Payload Cloud adds environments on paid plans.

WordPress has no native staging or environment branching. Most teams solve this with separate WordPress installs, WP Migrate DB for database syncing, or managed hosting environments (WP Engine, Kinsta) that provide staging slots. Schema changes cannot be previewed or rolled back in any structured way, a core limitation for iterative development.

Self-hosted with no CDN. Asset delivery via S3, Cloudinary, or local disk, CDN is your responsibility to set up.

WordPress itself does not deliver content via a CDN, that depends entirely on your hosting provider and caching plugins (WP Rocket, W3 Total Cache). In a headless setup, API responses come from a PHP application server, not a globally distributed edge network. Latency is highly dependent on infrastructure choices and requires deliberate engineering to optimise.

Requires Node.js and a database. v3 cohabitation removes one service but the database is still your responsibility.

Deploying and maintaining WordPress headless requires running two systems: the WordPress backend (PHP, MySQL, web server) and the decoupled frontend (Node.js, CDN, build pipeline). This is significantly more infrastructure than a managed headless CMS. WordPress.com and WP Engine simplify the WordPress side, but the overall system complexity is real.

Official Stripe, Cloudinary, and SEO plugins available. Community ecosystem is growing but less mature than others.

With over 59,000 plugins and 20+ years of community development, the WordPress ecosystem is unmatched in breadth. ACF, WooCommerce, Yoast, and hundreds of other well-maintained plugins solve real problems quickly. For headless specifically, WPGraphQL, Faust.js, and official hosting integrations with WP Engine and Kinsta make the setup viable. The caveat: plugin quality is highly variable, and in a headless context you only use a fraction of this ecosystem.

Highly active GitHub with fast maintainer response. Discord is engaged and growing since the v3 release.

WordPress's community is the largest in the CMS world, 40% of the web runs on it, and WordCamp events run globally. WPGraphQL and the headless ecosystem specifically have an active community and regular releases. However, the overall direction of WordPress is toward the full-site editing and block editor experience, not headless-first architecture, so community energy for headless specifically is a subset of the whole.