HeadlessNext.jsArchitecture
Headless WordPress: when it's worth it (and when it isn't)
A practical checklist for deciding whether to decouple WordPress with Next.js, drawn from real client projects.

Yusuf Mudagal
· 2 min read
Every few weeks a client asks whether they should "go headless." Sometimes the answer is yes. More often the honest answer is "not yet." Here is how I decide.
What headless actually buys you
When you decouple, WordPress keeps the content and the editorial workflow, and a framework like Next.js renders the front end. In practice you get:
- Speed you can control. Static generation, edge caching and fine-grained image handling.
- Freedom on the front end. You use React components rather than PHP templates.
- One content source for many channels. The website, the app and the kiosk all read from the same API.
What it costs you
Headless isn't free. You lose or have to rebuild:
- Previews that editors trust
- Plugins that render on the front end (forms, SEO output, page builders)
- A single deployment, because you now run two systems
Rule of thumb
If your bottleneck is a slow theme and 40 plugins, fix that first. Headless won't save a bloated site.
A minimal Next.js + WPGraphQL fetch
export async function getPosts() {
const res = await fetch(process.env.WP_GRAPHQL_URL!, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
query: `{ posts(first: 10) { nodes { slug title excerpt } } }`,
}),
next: { revalidate: 300 },
})
const { data } = await res.json()
return data.posts.nodes
}My decision checklist
| Signal | Go headless? |
|---|---|
| Multiple front ends (web + app) | ✅ Yes |
| Dedicated front-end team | ✅ Yes |
| Heavy reliance on page builders | ❌ Not yet |
| Small team, marketing-led site | ❌ Usually no |
If you're weighing this for your own stack, book a call and we can talk it through.