A headless CMS built for blogs and articles.
Write and organize posts in Marble, then deliver them to any website or app through a simple API.
What headless means here.
A headless CMS manages content but doesn't render your website. Marble gives your team an editor and a media library, then serves published posts as JSON. Your frontend, built with any framework, decides how they look.
That separation lets developers keep their own stack and design, while writers publish without touching code. The trade-off is that you build the pages yourself; Marble doesn't include themes.
What is a headless CMS?Workflow
From the editor to your API.
- 1
Write
Draft in a focused editor with headings, lists, code blocks, images, video, and YouTube or X embeds.
- 2
Organize
Attach authors, one category, tags, a cover image, and any custom fields your site needs.
- 3
Publish
Set the post to published. It becomes available through the API; drafts stay private.
- 4
Deliver
Your frontend requests posts with an API key and receives everything it needs to render in one response.
- 5
React to changes
Webhooks tell your site, Slack, or Discord when posts change, so pages can revalidate or rebuild.
{
"post": {
"id": "cmpb2ua350000psp7urk7c9u6",
"slug": "launch-week-recap",
"title": "Launch week recap",
"status": "published",
"description": "Everything we shipped this week.",
"coverImage": "https://cdn.marblecms.com/media/.../cover.webp",
"publishedAt": "2026-09-01T09:00:00.000Z",
"category": { "name": "Product", "slug": "product" },
"tags": [{ "name": "Releases", "slug": "releases" }],
"authors": [{ "name": "Ada Lovelace", "slug": "ada" }],
"fields": { "release_date": "2026-09-01" },
"content": "<p>This week we shipped...</p>"
}
}Everything a publication needs, nothing it doesn't.
Marble keeps the content model small so the editor stays simple and the API stays predictable.
- EditorRich text, code blocks, images, video, and embeds, with a readability score and AI writing suggestions on paid plans.
- Content modelPosts with multiple authors, one category, and many tags. Add typed custom fields for extra metadata.
- REST API and SDKSanitized HTML or Markdown, filters for categories, tags, and search, and a typed TypeScript SDK.
- API keys and scopesRead-only public keys for published content; private keys with scopes for drafts and write access.
- Media libraryUpload images, video, audio, and documents. Files are served from Marble's CDN with alt text and dimensions.
- WebhooksSigned deliveries in JSON, Slack, or Discord format, with automatic retries and a delivery log.
- Team workspacesInvite teammates as Owner, Admin, or Member. Each workspace keeps its own content, keys, and billing.
- Import and exportImport Markdown and MDX files as drafts. Export the whole workspace as JSON whenever you want.
- MCP serverConnect AI agents to search, draft, and update content through scoped tools.
Frameworks
Use it with the frontend you already have.
Anything that can make an HTTP request can read from Marble. These integrations have guides and examples.
Is Marble the right headless CMS for you?
Marble suits you if
- You publish articles, a blog, a changelog, or product updates on a site you build.
- Writers need a clean editor, and developers want a REST API without schemas to maintain.
- A small team shares a workspace and wants pricing per workspace, not per seat.
Look elsewhere if
- You need custom content types, localization, or a visual page builder. See Marble vs Sanity.
- You want newsletters, memberships, and a ready-made theme in one product. See Marble vs Ghost.
- You don't want to build a frontend. A traditional CMS with themes will be simpler.
- You need scheduled publishing or real-time co-editing, which Marble doesn't offer yet.
Weighing your options? Compare Marble with other content platforms.
Frequently asked questions
Common questions about Marble as a headless CMS.
What is a headless CMS?
A headless CMS stores and manages content, then delivers it through an API instead of rendering your website. You build the frontend with any framework. Read What is a headless CMS? for a longer explanation.
What kind of content is Marble for?
Blogs, changelogs, product updates, guides, and other post-based content. Every entry is a post with authors, one category, tags, and optional custom fields. If you need arbitrary content types or a page builder, a schema-based CMS is a better fit.
Does Marble host my website?
No. Marble hosts your content and media. You build and deploy the website yourself, with any framework and host.
Does Marble have a GraphQL API?
No. Marble has a REST API, a TypeScript SDK, and an MCP server for AI agents. Posts include their authors, category, tags, and custom fields, so one request is enough to render a page.
Is Marble open source?
Yes. The source code is on GitHub under the AGPL-3.0 license. Marble also runs it as a hosted service, so you don't have to operate a server or database.
Can I bring my existing posts, and take them with me?
Yes. Upload Markdown or MDX files, one at a time or as a ZIP, and Marble creates draft posts for review. You can export your workspace as a JSON archive at any time.
How much does Marble cost?
The Free plan includes unlimited posts, 1 GB of media storage, and 5,000 API requests a month. Hobby costs $5 a month and Pro costs $20 a month, with higher limits and more team members. See pricing for details.
Publish your first post.
Create a free workspace, write a post, and fetch it from your site with an API key.