Headless WordPress

Keep WordPress for writing. Give visitors something faster.

Headless WordPress keeps the admin your team already knows and replaces only the part visitors touch. Done well, nobody on your side notices the change except that the site got quicker. Done for the wrong reasons, it makes every future change slower and more expensive, so this page spends as much time on when not to do it.

Is it right for you?
This site is a headless WordPress build. 15+ years writing WordPress code.
dash.primocollab.com · Edit PostPublished
Title

Headless WordPress, Explained for Non-Developers

Content

“Headless WordPress” sounds like developer jargon, and the explanations usually stay that way…

Status

Published

Category

WordPress Development

Update

The post you can read on this site was written in exactly this screen.

Before anything else

Is headless WordPress actually right for your site?

It is the wrong answer more often than it is the right one. Four statements: the more of them that are true for you, the more sense this makes.

Speed is costing you something you can name

Not "the site feels slow", but a number: an ad campaign paying for bounces, a checkout losing people, a Core Web Vitals failure you have already been told about. Headless is a large change to make on a hunch.

Your content already outgrew one website

The same content has to appear somewhere else too: an app, a partner site, a kiosk, a second brand. This is the case where headless earns its cost fastest, because you write once and it appears everywhere.

Your front end changes rarely, your content changes often

Publishing a post every week is a good fit. Redesigning a landing page yourself every fortnight is not, because on a headless build that is a developer job rather than a drag and drop.

You have a developer, or you are hiring one

A headless site cannot be handed to a general WordPress freelancer the way a theme build can. If nobody will own the front end after launch, a well-built conventional theme will serve you better for years.

If none of those landed, say so and we will talk you out of it. A fast custom WordPress theme gets most sites most of the benefit at a fraction of the cost and complexity. That is what we would build instead.

What you get

What a headless build actually consists of

Two systems instead of one, which is exactly why it costs more and why it is faster.

Stays WordPress

The part your team touches

  • The same admin, the same editor, the same Publish button.
  • Real ACF field architecture, so every editable region is a labelled field rather than something hardcoded.
  • Your existing content, categories, users, and permissions, carried over as they are.
  • Content plugins keep working, because content is still WordPress's job.
Gets rebuilt

The part visitors touch

  • A custom front end built to your design, served as ready-made pages instead of assembled per visit.
  • Structured data, metadata, and sitemap generated at build time, not bolted on by a plugin.
  • Front-end plugin jobs rebuilt properly: forms, search, galleries, and anything else the theme used to do.
  • Hosting that serves files from a CDN, which is usually cheaper than the server it replaces.
Moving an existing site

How a migration runs without losing what you have earned

Most headless work is not a new site, it is an existing WordPress site that has hit a ceiling. The risk in that is rankings, so the URLs come first, not last.

01

Audit before quoting

Every plugin gets sorted into keeps working, needs rebuilding, or can go. That list is what the quote is built on, and you see it before you commit to anything.

02

Map every URL first

Your current URLs are written down and matched to their new addresses before a line of the front end is built. Anything that has to change gets a redirect, planned up front rather than discovered afterwards.

03

Build alongside the live site

The new front end reads from your real WordPress content while the current site stays up and untouched. You review the real thing with real content, not a mockup.

04

Switch, then watch

The switch is a DNS change with the redirects already live. Then Search Console gets watched for the weeks that follow, because a migration is judged by what happens after launch, not on launch day.

Headless WordPress questions we get asked

The ones that come up before someone commits, including the awkward ones.
Don't see yours? .

Will my team still edit the site in WordPress?

Yes, and that is the point. Your team logs into the same WordPress admin, writes in the same editor, and hits Publish the same way. The only difference is what happens after Publish: instead of WordPress rendering the page for every visitor, the page is built once and served ready-made. Nothing about the day-to-day changes for whoever writes your content.

How long does it take for a change to appear on the live site?

Under a minute on a normal site. Publishing triggers a rebuild of the pages that changed and the new version goes live automatically. It is not instant the way a traditional WordPress edit is, and that trade is the honest cost of headless. If your site needs edits to appear the same second, headless is the wrong choice and we will tell you so.

Do my plugins still work?

Content plugins do. Anything that manages or structures content, ACF included, keeps working normally. Plugins that render things on the front end do not, because the front end is no longer WordPress: sliders, form builders, page builders, and most SEO plugins output nothing. Their jobs get rebuilt on the new front end instead. We audit your plugin list before quoting so there are no surprises.

Can you move an existing WordPress site to headless without losing rankings?

Yes, and the URLs are the part to get right. Your content, metadata, and URL structure carry over, with a redirect plan for anything that has to change. This site is a headless WordPress build and its old WordPress URLs still redirect one for one to their new addresses, which is the same approach we use on client migrations.

Is headless more expensive to run?

The build costs more than a theme build because there are two pieces to make instead of one. Hosting is usually cheaper, because the public site is static files on a CDN rather than a server running PHP for every visitor. Where it costs you is change: anything on the front end needs a developer, not a page builder.

What happens if we want to leave later?

Your content never left WordPress, so it is all still there in a standard WordPress install that any WordPress developer can pick up. The front end is yours outright, in your repository, with no licence and no dependency on us. Moving back to a conventional theme is a rebuild of the front end only.

Do you work white label for agencies?

Yes. We build headless WordPress under NDA for design, dev, and marketing agencies who need the capability without hiring for it. Deliverables carry your branding, and you set your own pricing to your client.

Get started

Not sure whether headless is worth it for your site?

Describe what the site does and what is going wrong. You will get a straight answer about whether headless is the right call, including when it isn't, from the developer who would do the work.