guides/headless-wordpress.html

WHEN HEADLESS WORDPRESS PAYS

The decision tree for picking between classic WordPress, headless WordPress, and a fully custom Next.js stack. With real cost numbers.

WHEN HEADLESS WORDPRESS PAYS

← Blog

What headless WordPress actually is

Headless WordPress means using the WordPress backend (admin, content modelling, plugin ecosystem) but rendering the public-facing site with Next.js, Astro, or another modern framework. Content is fetched via WPGraphQL or the REST API, then rendered server-side or statically by the frontend.

The marketing-page promise is "best of both worlds": WordPress's editor familiarity plus modern frontend performance. The reality is more nuanced. Headless adds maintenance complexity that not every team should sign up for.

When it pays

Headless WordPress is the right call when all four of these are true: the editorial team is committed to WordPress and will not move, performance is part of the brand or revenue brief, the design language is unusual enough that a WordPress theme cannot deliver it, and the team has both editorial and engineering maturity.

Concrete examples we have shipped: high-traffic publications where Lighthouse scores affect ad revenue, marketing sites for developer-tools companies where the brand demands custom frontend work, brand sites where the WordPress-theme aesthetic ceiling is below what the client requires.

Typical engagement size: 25,000 to 90,000 USD for the migration plus three to twelve months of ongoing engineering capacity to maintain the bridge.

When it does not pay

Headless WordPress is the wrong call when any of these is true: the team has neither editorial nor engineering maturity, the site is genuinely a brochure site that gets edited monthly, the budget cannot sustain double-stack maintenance over twelve months, or the editorial team needs Yoast / Rank Math features to surface on the frontend.

In these cases, classic WordPress on managed hosting plus Cloudflare delivers 90 percent of the headless performance benefit at 20 percent of the engineering cost. The math nearly always favours classic for typical small-business sites.

The honest cost over twelve months

Classic WordPress on Kinsta: roughly 2,000 USD/year hosting + 3,000 to 8,000 USD/year maintenance retainer = 5,000 to 10,000 USD total.

Headless WordPress on Vercel + Kinsta: roughly 4,000 USD/year hosting (both layers) + 8,000 to 25,000 USD/year maintenance + occasional engineering work on the bridge = 12,000 to 30,000 USD total.

The headless math works when the performance / brand / design upside justifies the 2x cost. It does not work for most sub-mid-market sites.

WHEN YOU ARE READY TO TALK

If you are mid-build on something this guide touches and want a second pair of eyes, the fastest path is a 30-minute call.

BOOK YOUR 30-MIN CALL