Glossary · Platforms
Headless CMS
A headless CMS is a content management system that stores and edits content but does not build the pages that show it. Your website asks it for the content over an API and makes the pages itself. The “head” it leaves out is the part visitors see.
An example
A writer publishes a post in the CMS’s dashboard. The website, wherever it is built, asks for that post by its slug with a read-only key:
curl https://api.cmskite.com/v1/blog/posts/slug/wedding-cake-guide \
-H "authorization: Bearer csk_live_..."The answer is data, not a page: the title, the body, the author, the dates and the search fields. The site puts them into its own design. A traditional CMS such as WordPress does both halves, storing the post and serving the page.
Why it matters for a small-business blog
It is a question of who built your website. If a developer, or an AI app builder such as Lovable or Bolt, made it in code, a headless CMS gives the people who write a dashboard of their own, and the site shows new posts without being rebuilt by hand. If your site is on a builder with a blog of its own and you are happy with it, you probably do not need one.
The trade-off is that the website now does the work a traditional CMS did: making each post’s page, its title and description, its canonical link and its sitemap entry. Done well, that is fast and fully yours. Done badly, the blog looks fine to you and is invisible to search engines.
Common mistakes
- Fetching posts in the browser. If the post’s text arrives after the page loads, crawlers that do not run JavaScript see an empty page; Google’s own guidance notes that not all bots can run it. Fetch on the server, where the HTML is made.
- Forgetting the head. The title, meta description, canonical link and structured data are now your site’s job. A headless CMS can hand you the values; it cannot put them in your HTML.
- No sitemap for the posts. The site’s sitemap is usually written by hand or by the framework, and does not know about posts that live in the CMS.
- Choosing for the developer only. The people who write every week use the editor, not the API. Try writing a post in it before you choose.
How CMSKite handles it
- It is a headless CMS for blogs. Posts, categories, tags, authors and images, read over a REST API, a TypeScript SDK and an MCP server. It does not manage your other pages or products.
- The search work comes ready. Every post carries a
seoblock (title, description, canonical, social image, noindex) with every key present, andGET /v1/blog/sitemaplists the posts at your site’s addresses. Making your posts findable is the checklist. - Not only headless. For a site without a developer, the same posts show on a free blog link that we render as finished HTML, or on any site through a two-line embed.
- The key in your site can only read. It sees published posts only, and a browser may use it only on the website set in your project. See the quickstart.
Sources
Questions
- Is a headless CMS good for SEO?
- It can be as good as any, because your site controls the HTML. It is only as good as that site, though: posts have to be rendered on the server, with their own title, description, canonical link and sitemap entry.
- Is WordPress a headless CMS?
- Not by default: it stores posts and serves the pages. It can be used headless through its REST API, with another site making the pages.
Related
- Embed codeThe other way to show posts, with no code of your own.
- Structured data (JSON-LD)One of the things your site now writes.
- For developersThe API, the SDK and the MCP server.
- QuickstartFrom sign-in to your first request in five steps.
- Making your posts findableWhat a headless site has to do for search.
Checked