wordpress-headless.html

Headless WordPress

WordPress as a back-end via WPGraphQL or REST. Editorial team keeps wp-admin; public site is modern.

VISIT HEADLESS WORDPRESS

Quick facts

  • CategoryLegacy / Headless mode
  • LanguagePHP
  • PricingOpen source
  • LicenseGPL-2.0
  • Created2003
  • GitHub stars19.5k
  • Statusactive

What it is

WordPress used headlessly is the most-deployed pattern in this entire directory by raw site count. The editorial team keeps wp-admin (which they already know); a Next.js or Astro front-end consumes the data via WPGraphQL or the REST API. Excellent for migrations off legacy WordPress where the team will not retrain.

Best for

  • WordPress sites migrating to a modern front-end without changing the editorial workflow
  • Editorial teams with WordPress muscle memory and no appetite for a new admin UI
  • Projects with significant WordPress content history (12,000-site agency reality)

When not to pick it

Skip headless WordPress for greenfield projects where the team has no prior WP investment — Payload, Sanity, or Astro Content Collections are cleaner. Also skip if your team will fight the WP-style content model.

My take

Headless WordPress is the right answer when the editorial team is the bottleneck and they already live in wp-admin. New projects with no WP legacy almost never pick it. The 12,000-site experience says: pick by team, not by framework.

Links

Compare Headless WordPress side-by-side

Headless WordPress vs Sanity → Headless WordPress vs Payload → Headless WordPress vs Ghost →

Similar tools you should also consider

Payload

Self-hosted TS-first CMS over Postgres. The new default for owned-stack content.

Read the take →

Strapi

Open-source Node-based headless CMS. Mature, flexible, the original self-hosted default.

Read the take →

If Headless WordPress is your pick — the next conversation is short

The 30-min call is where your CMS choice becomes a real architecture, an editorial workflow your team can adopt, and a price range you can take to your stakeholders. Describe your content estate, your team\'s muscle memory, your timeline. I tell you whether Headless WordPress is genuinely your fit.