Skip to main content
Headless WordPress

Headless WordPress with Astro or Next.js

Your team keeps editing in WordPress. The visitor gets a front end built with Astro or Next.js and served from a CDN. We tell you what you gain, what it costs and when it is not worth it.

webhookdeploy
Editor
publishes content
WP
WordPress
CMS only · API
Astro / Next.js
builds the front end
CDN
static HTML

Headless WordPress separates the content manager from the public website. WordPress stores and edits the content and exposes it through the REST API or WPGraphQL; an Astro or Next.js front end consumes it and generates the pages, which are served from a CDN. Soamee builds these architectures while keeping the editor the team already knows. The cost is real: SEO, forms and preview stop coming from plugins and have to be built in the front end. That is why we recommend it when front-end performance or control is a requirement, and not as a trend.

Architectures

Three ways to set it up

The choice depends on how often content changes and whether there are dynamic parts.

Static generation with Astro

Every publish triggers a site build and the resulting HTML goes to the CDN. It is the fastest and cheapest to serve, and fits corporate sites, blogs and catalogues that change infrequently.

webhookHTML
WP
WordPress
publish
Build
fetches content from the API
CDN
pages already built
Trade-offs

What changes compared with classic WordPress

Headless is not better by default. Here is what you gain and what has to be built by hand.

Classic WordPress Headless WordPress
The theme renders the page on every request, with PHP and database queries
The front end serves prebuilt HTML from a CDN and WordPress receives no public traffic
SEO, form and cache plugins just plug in
SEO, forms and metadata have to be built in the front end: you gain control and lose plug-and-play
The preview is the page itself
The preview has to be built with a draft mode
One system to update and protect, but exposed to the public
Two systems to deploy, with WordPress hidden behind an API

Not sure headless makes sense for your site?

Let's assess it together →
SEO

Changing front end without losing rankings

To Google, a front-end change is a platform change. Before touching anything we inventory the URLs and cross them with Search Console to see which ones receive traffic. Those URLs are kept as they are or redirected with a 301 to their equivalent.

The titles, descriptions, canonicals, hreflang and structured data that a plugin used to output are reproduced in the new front end and compared with the original site before launch. After the switch, crawling is monitored in Search Console for the following weeks.

FAQ

Frequently asked questions about headless WordPress

What is headless WordPress?
It means using WordPress only as the content manager. Editors keep the usual admin, but the website the visitor sees is built by a separate front end (Astro, Next.js) that fetches content from WordPress through the REST API or WPGraphQL.
What do you gain and what do you lose?
You gain control of the front end, static pages from a CDN, and WordPress no longer being exposed to public traffic. You lose the convenience of plugins that render things on the page: SEO, forms, caching or search have to be solved in the front end. It is more work up front and only pays off when front-end performance or control is a requirement.
Can the current search rankings be kept?
Yes, if it is planned. URLs are kept or redirected with 301s, metadata and structured data are reproduced in the new front end, and crawling is compared before and after the change.
What about draft previews?
A preview mode handles it: the editor clicks Preview in WordPress and the front end shows the authenticated draft without publishing it.
Does it work with WooCommerce?
Yes. Catalogue and orders live in WooCommerce and the front end queries them through the API. There are more moving parts than in a content site (cart, sessions, checkout), so we assess it case by case. More detail on the WooCommerce page.
Let's start

Same editor, different front end

We review your current WordPress and tell you whether headless solves your problem or whether a cheaper fix exists.

Headless WordPress with Astro or Next.js

Tell us your challenge. We'll propose a solution.

No commitment. Within 24 hours, you'll receive a proposal with scope, timeline and budget. No fine print.

Book a free call →