Updated September 2026 · Written and maintained by the Progression Agency strategy team
Headless WordPress keeps WordPress as the content editor and replaces the theme with a separate front end, usually Next.js or Astro, that fetches content through the REST API or WPGraphQL. This guide explains how headless WordPress works, what changes for editors and developers, previews and plugins, hosting for both halves, performance and security gains, costs, the cases where it is worth it and the cases where a well-hosted traditional WordPress site is the better answer.
On this page · 9 sections
- How headless WordPress works
- What changes for editors
- What changes for developers
- Performance and security gains
- Costs of headless WordPress
- Headless WordPress vs traditional WordPress
- Headless WordPress vs a dedicated headless CMS
- When to go headless with WordPress
- How Progression Agency builds headless WordPress
The short answerGo headless with WordPress when the site must be very fast and secure, when content feeds more than one channel, when the front end is a custom React or Astro build anyway, or when the site is a product with logged-in features. Stay traditional when marketers must build pages with blocks and page builders unaided, when plugin-driven features (forms, memberships, WooCommerce) are central, or when the budget is under about $25,000. Typical stack: WordPress on managed hosting as the CMS, WPGraphQL, Next.js on Vercel or Astro on Cloudflare Pages, with webhooks rebuilding or revalidating pages on publish.
Comparisons are based on each project’s official documentation as linked in the text. Progression Agency builds with all of the technologies compared and has no affiliate relationship with any of them.
How headless WordPress works
WordPress runs as usual (admin, editors, media, plugins for content types) but nobody visits its theme; a separate front end requests content through the WordPress REST API or the WPGraphQL plugin and renders pages itself. On publish, WordPress calls a webhook that rebuilds static pages or revalidates cached ones. The admin can be hidden from the public internet entirely. See headless CMS vs traditional CMS for the general architecture.
What changes for editors
Content editing in the block editor stays the same; page building does not. Blocks render through the front end’s components, so new layouts need developer work, page builders such as Elementor stop meaning anything, and previews must be wired up (WPGraphQL preview support, Next.js draft mode, or WP Engine’s Faust.js). Editors gain speed and reliability and lose some independence.
What changes for developers
The front end is a normal Next.js or Astro project: routing, components, data fetching from WPGraphQL, image handling through the framework, SEO metadata from Yoast or Rank Math exposed via their GraphQL extensions, and forms handled by the front end or an API. Plugins that inject markup or scripts into the theme do nothing; plugins that model content (ACF, custom post types) matter more. See Next.js vs React and Astro vs Next.js.
| Layer | Common choice | Notes |
|---|---|---|
| CMS hosting | Managed WordPress host (Kinsta, WP Engine, Pressable) or a locked-down VPS | Admin can be IP-restricted; see WordPress hosting guide |
| API | WPGraphQL (plus ACF and Yoast extensions) or REST | GraphQL is easier for typed front ends |
| Front end | Next.js (App Router) or Astro | Next.js for apps, Astro for content sites |
| Front-end hosting | Vercel, Cloudflare Pages, Netlify | See Vercel vs Netlify |
| Previews | Next.js draft mode with WPGraphQL, or Faust.js | Must be planned, not bolted on |
| Rebuilds | Webhooks on publish to trigger ISR revalidation or a rebuild | Seconds to minutes |
| Forms and search | Front-end forms to an API; Algolia, Meilisearch or WP search via API | Theme-dependent plugins do not apply |
| Media | WordPress media library served via CDN, optimized by the framework | Cloudflare or the host CDN in front |
Performance and security gains
The public site becomes static or edge-rendered HTML with a small JavaScript footprint, which is why headless WordPress sites usually pass Core Web Vitals comfortably. The WordPress admin and PHP runtime can sit behind authentication or an IP allowlist, removing the most attacked surface of a WordPress site from the public internet. See speed optimization and website security services.
Costs of headless WordPress
| Item | Range | Notes |
|---|---|---|
| Build (business site, 20-50 pages) | $25,000-$90,000 | Custom front end plus content modeling and previews |
| CMS hosting | $20-$300 per month | Managed WordPress host |
| Front-end hosting | $0-$200 per month | Static is nearly free; SSR costs usage |
| Layout changes | Developer time | Marketers edit content, not layouts |
| Maintenance | $150-$800 per month | Two systems; see WordPress maintenance services |
Headless WordPress vs traditional WordPress
| Traditional WordPress | Headless WordPress | |
|---|---|---|
| Page building by marketers | Yes (blocks, builders) | Limited to designed components |
| Plugins for features | Full ecosystem | Content-modeling plugins only |
| Performance | Depends on hosting and theme | Excellent by default |
| Security surface | Public PHP site | Admin can be private; public site static |
| Multi-channel content | Via API, with effort | Native |
| Build cost | Lower | Higher |
| Best for | Marketing sites, plugin-driven features | Fast custom sites, products, multi-channel |
Headless WordPress vs a dedicated headless CMS
Headless WordPress wins when the team already knows WordPress and the content lives there; Sanity, Storyblok or Payload win when you are starting fresh and want purpose-built modeling, previews and hosting without running WordPress at all. See best headless CMS platforms.
When to go headless with WordPress
- The site must be among the fastest in its category and pass Core Web Vitals without tuning.
- Content feeds an app, kiosks, partner sites or several brands.
- The front end is a Next.js or Astro build anyway (product site, portal, custom design).
- Security policy wants the CMS off the public internet.
- Editors are happy editing content and do not need to build pages themselves.
How Progression Agency builds headless WordPress
Managed WordPress hosting for the CMS with WPGraphQL and ACF, a Next.js or Astro front end on Vercel or Cloudflare, previews and webhooks wired up, and a migration path that keeps URLs and rankings. See WordPress development company, Next.js development company and website migration services.
Thinking about headless WordPress?
Tell us who edits the site and what it must do; we will say whether headless is worth it and quote both routes.
Getting found in search
AI, AEO and what is changing
Paid media and lead generation
Websites and design
Choosing and working with an agency
Software and app development
Web development, platforms and hosting
- React vs Vue vs Angular
- Svelte vs React
- Astro vs Next.js
- Next.js vs React
- Web development frameworks
- What is a tech stack
- SSR vs CSR vs SSG
- React Native vs Flutter
- Vercel vs Netlify
- Cloudflare vs AWS
- AWS vs Azure vs Google Cloud
- Web hosting types compared
- Hosting for React and Next.js
- SaaS hosting
- WordPress hosting guide
- Backend hosting options
- Website hosting for small business
- Headless CMS vs traditional CMS
- WordPress alternatives
- Best CMS platforms
- Webflow vs WordPress
- Wix vs Webflow
- Framer vs Webflow
- Shopify vs WooCommerce
- Custom software vs off-the-shelf
- Website development cost
- Monolith vs microservices
- Custom website development services
- React development company
- Next.js development company
- WordPress development company
- Webflow development agency
- Front-end development company
- WordPress maintenance services
- Ecommerce website redesign services
- Website migration services
- DevOps services
- Cloud migration services
- Website speed optimization services
- Website security services
- VPS hosting explained
- Website hosting cost
- Cloud hosting explained
- Hosting a website on AWS
- Hosting a website on Google Cloud
- Hosting a website on Azure
- Dedicated server hosting
- Shared hosting explained
- WooCommerce hosting
- PHP hosting
- .NET hosting
- Best headless CMS platforms
- Static site generators compared
- Small business website redesign services
- Angular development company
Social, content and brand
By industry and by situation
Frequently asked questions
What is headless WordPress?
Headless CMS vs WordPress: which should I choose?
Is headless WordPress better?
What is WPGraphQL?
Can editors still use the block editor?
Do WordPress plugins work with headless?
Is headless WordPress good for SEO?
How much does headless WordPress cost?
Where do you host headless WordPress?
Do previews work in headless WordPress?
Can WooCommerce go headless?
Headless WordPress or Sanity?
Can I migrate my WordPress site to headless?
Does Progression Agency build headless WordPress sites?
Is WordPress headless CMS use common?
Planning a website or web app?We design, build, deploy and host custom websites, React and Next.js applications and WordPress sites, with a written scope first.
Get a free marketing proposal
Tell us what you are trying to grow and we will come back with a plan, not a pitch deck. Same-day reply on weekdays.