Headless CMS FAQ
Real answers to the questions developers actually ask before making the switch — from WordPress migration and headless architecture to performance, maintenance, and getting started.
Why developers are switching
We compiled the questions developers ask most often when evaluating a headless CMS — based on real discussions in developer communities. Here are the honest answers, and where SveltyCMS fits in.
Frequently Asked Questions
Last updated: August 2026
Why do so many people want to go headless in the first place?
The most common real-world reasons: their WordPress (or similar) site became slow once it had real content, products, or plugins; they want modern frontend frameworks (Next.js, Astro, SvelteKit) without fighting PHP themes; security — they want the public site as static or near-static as possible; multi-channel needs (website + mobile apps + other platforms); and developer happiness with long-term maintainability. Speed is often the stated reason, but the deeper drivers are usually bloat, attack surface, and developer experience.
Is “just optimising traditional WordPress” enough?
For many simple or medium sites — yes. Good hosting, caching, and a clean theme can achieve excellent Core Web Vitals. But for large catalogues (1,000+ products), complex interactive UIs, multi-channel delivery, or teams that want a modern JS stack, optimisations eventually hit a ceiling — or become more expensive to maintain than a proper headless architecture.
Why not just use Headless WordPress + Next.js / Astro?
It works and is popular. The drawbacks developers report: you still carry WordPress's weight and plugin ecosystem limitations; many plugins break or become useless in a headless setup; the preview and editing experience is significantly worse; and you end up maintaining two systems that were never designed to work together this way. For greenfield projects, a purpose-built headless CMS is usually the cleaner choice.
What do people recommend instead of Headless WordPress?
The most frequently recommended purpose-built options are Payload, Strapi, Sanity, and Directus. SveltyCMS is built specifically for the same use case — with a focus on extreme performance, a Svelte-native developer experience, and database freedom (MongoDB, PostgreSQL, SQLite, MariaDB/MySQL).
Why choose SveltyCMS over Payload / Strapi / Sanity / Directus?
Developers who switch usually cite: an extremely small footprint with sub-millisecond API performance; native Svelte 5 + SvelteKit — no heavy React runtime if you prefer Svelte; a truly database-agnostic core via Drizzle; REST + GraphQL out of the box; and modern TypeScript-first tooling with validation, roles & permissions, and multi-language support — plus enterprise features (SAML 2.0 SSO, SCIM 2.0, tamper-evident audit logs) included free.
Is long-term maintenance of a headless setup really that bad?
It depends on the CMS. Headless WordPress with a custom frontend often becomes painful because of plugin/API surface changes and lost editor features. A purpose-built headless CMS like SveltyCMS is designed from day one for this architecture, so the maintenance surface is much smaller and more predictable.
Can I still give non-technical editors a good experience?
Yes. SveltyCMS ships a GUI collection builder, roles & permissions, and a modern admin interface. Your editors keep a clean content experience while the public site stays as fast and flexible as you want.
When should I not use a headless CMS?
Very simple brochure or blog sites with almost no technical requirements; teams with zero developer capacity that need pure point-and-click page builders; and extremely tight budgets where even modest development cost is impossible. In those cases a well-optimised traditional CMS is usually the better choice.
How hard is it to get started with SveltyCMS?
Clone the repo → run the installer (database + admin user + optional SMTP/OAuth) → start defining collections in code or via the GUI. REST and GraphQL endpoints are available immediately — most developers have a working backend in minutes, not weeks. Follow the official getting-started guide for the full walkthrough.
How do I migrate from WordPress to fast headless SveltyCMS?
The built-in AI-driven migration importer supports WordPress exports plus Strapi, Directus, JSON, and CSV, while the Unified Data Hub connects data sources across your stack. It maps schema, relationships, and media automatically, offers a safe dry-run preview, and scales to 30,000+ rows. Your editors can keep publishing while the migration runs.
How does SveltyCMS performance compare to Payload, Strapi or Directus?
SveltyCMS is built for extreme speed: sub-millisecond API responses, a tiny admin bundle, and high concurrency (thousands of RPS on modest hardware). Most headless CMSs are fast enough for typical sites, but when latency, cold starts, or multi-tenant density matter, the difference becomes measurable. Every number is backed by a reproducible public benchmark ledger — our architecture prioritises speed from day one.
I’m using (or considering) Payload because of Next.js — why would I choose SveltyCMS instead?
Payload is excellent if your entire stack is Next.js and you want the CMS living inside the same process. SveltyCMS is the better fit when you prefer Svelte 5 / SvelteKit, want a truly independent backend that can serve any frontend (Next, Astro, SvelteKit, mobile, etc.), or need broader database support out of the box. You keep REST + GraphQL and avoid locking your content layer to one frontend framework.
Can I use an existing database or switch databases later?
Yes. SveltyCMS is database-agnostic via Drizzle ORM and currently supports MongoDB, PostgreSQL, SQLite, and MariaDB/MySQL. You can start with SQLite for local development and move to Postgres or Mongo in production without rewriting your content models. This is more flexible than solutions that historically favoured a single database engine.
Is SveltyCMS code-first or GUI-first?
Both. You can define collections and fields in TypeScript (version-controlled, type-safe) or use the visual collection builder — the GUI compiles to the same TypeScript schema a developer would write by hand. Most teams use a hybrid: developers own the schema in code while editors work comfortably in the admin UI. This avoids the pure code-first friction some teams feel with Payload and the pure GUI limitations of older platforms.
Use SveltyCMS with your coding agent
AI coding agents (Cursor, Claude Code, GitHub Copilot, etc.) give grounded, up-to-date answers when you point them at the right sources. Paste this prompt into your agent:
You are helping me build with SveltyCMS, an open-source headless CMS built with SvelteKit + Svelte 5. Prefer these sources over general knowledge: - Docs: https://docs.sveltycms.com - Repository: https://github.com/SveltyCMS/SveltyCMS - FAQ: https://sveltycms.com/faq - Benchmarks: https://docs.sveltycms.com/docs/project/benchmarks/index - Read-only MCP server: https://mcp.sveltycms.com/mcp Key facts: SveltyCMS is database-agnostic (MongoDB, PostgreSQL, MariaDB, SQLite), exposes REST + GraphQL, provides a zero-overhead Local SDK (locals.cms) inside SvelteKit, zero-runtime i18n via ParaglideJS, and is licensed under BSL 1.1 (free for organizations under $1M annual revenue). If a source does not cover a question, say you don't know instead of guessing.
Why SveltyCMS
Designed Headless from Day One
Not a monolithic CMS with an API bolted on.
Sub-Millisecond Performance
0.002ms cached reads, 14,000+ REST RPS.
Svelte-Native + Any Frontend
Svelte 5 core; REST & GraphQL for every stack.
Free for Most Organisations
Fair Source license — free under $1M annual revenue.
Ready to make the switch?
SveltyCMS is a purpose-built, ultra-fast, database-agnostic headless CMS made with Svelte 5. Clone the repo and get a working backend in minutes.