Websites and Tech

Headless CMS

Also called Decoupled CMS, API-first CMS

A content system that stores and serves content through an API, leaving the front end to be built separately.

Quick facts: Headless CMS

Category
Websites and Tech
Also called
Decoupled CMS, API-first CMS
Level
Advanced
Affects
Development cost, editing experience, SEO control, multi-channel reuse
Where to see it
Contentful, Sanity, Strapi, WordPress REST API
In this article4
  1. How a headless CMS works
  2. Why a headless CMS matters
  3. Where headless goes wrong
  4. How to decide

How a headless CMS works

A traditional content management system does two jobs: it stores content and it renders the pages visitors see. A headless system does only the first. Editors work in an admin area as usual, but instead of producing HTML, the system exposes the content through an API. Something else — a JavaScript application, a static site generator, a mobile app, a screen in a shop — requests that content and decides how to display it.

The word headless refers to the missing head, the presentation layer. Contentful, Sanity, Strapi and Storyblok are built this way from the start, and WordPress can be used headlessly through its REST or GraphQL interfaces while keeping its editing tools.

Why a headless CMS matters

The case for it is reuse. If the same product description has to appear on a website, in an app, on a partner’s site and on a display in a branch, writing it once and serving it to all of them beats maintaining several copies that drift apart. Developers also gain freedom: the front end can be rebuilt or replaced without touching the content store.

There is a security and performance argument too. With no public admin area attached to the site itself and pages often served as pre-built files, the surface an attacker can reach is smaller and the pages can be delivered very fast.

Where headless goes wrong

The commonest mistake is choosing it for a site that has one front end and no second channel. You take on two systems, a build process and a developer dependency, and you get back flexibility you were never going to use. Editors lose things they took for granted: preview, in-place editing, the ability to see the real page before publishing, and often the simple act of changing a menu.

SEO work becomes explicit rather than automatic. Titles, meta descriptions, canonical tags, redirects, sitemaps and structured data are handled by plugins in a traditional system; in a headless build somebody must design fields for them and code them into the front end, and they are frequently forgotten until traffic drops. Rendering matters too — if pages are assembled in the browser rather than on the server, crawling and JavaScript SEO problems follow.

How to decide

Ask what the second consumer of the content is. If you can name it and it exists, headless is a reasonable answer. If the honest answer is that there is only a website, a conventional system will publish faster and cost less to run, and no visitor will know the difference.

If you do go headless, plan the editing experience and the SEO fields as part of the build rather than as a later addition, and decide early whether pages are rendered ahead of time or in the browser. Above all, budget for the front end as a permanent piece of software with its own maintenance, because that is what it is.

Do and do not

Do

  • Name the second channel before choosing headless
  • Design SEO fields and redirects into the build
  • Decide early where pages are rendered

Do not

  • Go headless for a single marketing website
  • Leave editors without preview or menu control
  • Assume plugins will supply sitemaps and meta tags

Questions people ask about this

Is a headless CMS better for SEO?

It is neither better nor worse by itself. What changes is that nothing is handled for you: titles, descriptions, canonicals, redirects, sitemaps and structured data all have to be built deliberately. Done well, a headless site can be very fast and rank strongly. Done without a plan, it launches missing basics a conventional platform would have supplied.

Can I use WordPress as a headless CMS?

Yes. WordPress can serve content through its REST API or a GraphQL plugin while a separate front end renders the pages. Editors keep the admin tools they know. The trade-off is that preview, the site editor and many SEO plugins assume they control the front end, so parts of them stop applying.

Will a headless build cost more?

Usually, because you are commissioning a front-end application as well as configuring a content system, and both need maintenance afterwards. The cost can be justified when several channels share the same content or when performance requirements are unusual. For a single marketing website it rarely pays for itself.

Related terms

Found this useful?

Share it, or ask an AI to summarise it

Back to the glossary

Knowing the term is the easy part

Applying it to your own site and budget is the work. Book a call and I will tell you what actually applies to you.