What Is A Headless CMS?
What Is A Headless CMS?
A headless CMS is a back-end content management system where the content "body" is separated from the presentation "head."
In normal human terms: Your content lives in one place. Your website lives somewhere else. They talk via API.
Traditional CMS vs Headless
Traditional (WordPress, Drupal)
Your content and your presentation are locked together:
- Write post in WordPress
- WordPress generates HTML
- WordPress serves the page
- You're stuck with WordPress themes
Headless (Contentful, Sanity, Strapi)
Your content is just data:
- Write post in CMS
- CMS serves JSON via API
- Your React/Vue/Whatever app fetches it
- You control every pixel
Why I Use Headless
1. Frontend Freedom
Want to rebuild your site in Next.js? Go for it. The content doesn't care. It's just JSON.
Want to add a mobile app? Same API. Same content.
Want to send content to your smart fridge? Weird, but possible.
2. Developer Experience
| Traditional | Headless |
|---|---|
| PHP templates | React components |
| Plugin conflicts | NPM packages |
| Slow admin panels | Fast, focused CMS |
| Theme hacking | Full design control |
| Database worries | CDN-delivered content |
3. Performance
Headless sites are fast because:
- Static generation at build time
- CDN distribution
- No database queries on page load
- Optimized images and assets
My Setup
I use Contentful for this site:
// Fetch blog posts
const posts = await contentful.getEntries({
content_type: 'personalBlog',
order: '-fields.publishDate',
});
// Use in React
posts.items.map(post => (
<BlogCard
title={post.fields.title}
body={post.fields.body}
/>
));
Content writers use Contentful's nice UI. I write React. Everyone's happy.
When Headless Makes Sense
✅ Custom designs - You want full control
✅ Multiple frontends - Web + app + IoT
✅ Performance matters - Static sites are fast
✅ Developer workflows - Git, CI/CD, modern tooling
✅ Future-proofing - Swap frontends, keep content
When Traditional Makes Sense
✅ Simple blogs - WordPress is fine, honestly
✅ Non-technical users - Easier to manage
✅ Tight budgets - Shared hosting is cheap
✅ Existing expertise - If your team knows WP
The Bottom Line
Headless isn't always the answer. But if you're building modern web apps with React/Next.js/Vue, it's usually the right choice.
Your content becomes portable. Your frontend becomes flexible. And you stop fighting your CMS to make things look right.
—Greg, who escaped WordPress and never looked back