# KeystoneJS to Storyblok migration

> How to migrate from KeystoneJS to Storyblok, with a side-by-side comparison and FAQs.

---

## Source: KeystoneJS

- **Type:** headless
- **Official site:** https://keystonejs.com
- **Last reviewed:** 2026-07-28

## Key advantages

KeystoneJS is one of those tools that really clicks if your team thinks in code. It's a schema-driven, open-source headless CMS built on Node.js, and the developer experience is genuinely good. You define your content models in TypeScript, Keystone generates a GraphQL API and an admin UI for you, and you're off. There's very little magic or abstraction hiding what's happening under the hood, which we appreciate when building complex projects for clients.

The Prisma ORM integration is a real highlight. Automatic migration generation, type-safe database access, and support for PostgreSQL, MySQL, and SQLite mean you're not fighting your data layer. If you've ever had to wrangle a CMS into supporting a non-trivial relational content model, you'll understand why this matters. Keystone lets you express those relationships cleanly and query them with a proper GraphQL API.

The document field editor is also worth mentioning. It's one of the more thoughtful rich text implementations we've seen in a headless CMS. You can embed custom React components directly into the editor, which means content teams can work with your actual design system components rather than generic blocks. For teams that care about structured content, Keystone gives you real tools to enforce it.

Where Keystone really shines is in projects where the development team wants full ownership of the stack. There's no vendor lock-in, no proprietary query language, and no surprise pricing tiers. If you want a CMS that feels like a well-designed library rather than a platform, Keystone delivers on that promise.

### Schema-as-code with full TypeScript support

Define your entire content model in TypeScript with strong type inference throughout. The schema drives everything from the database to the admin UI to the GraphQL API.

### Automatic GraphQL API generation

Every content type you define automatically gets a full CRUD GraphQL API with filtering, pagination, and relationship resolution. No manual endpoint wiring needed.

### Prisma-powered database layer

Built on Prisma ORM with automatic migration generation and type-safe queries. Supports PostgreSQL, MySQL, and SQLite out of the box.

### Flexible document field editor

The rich text editor supports custom embedded components that map to your design system, giving content editors structured authoring without sacrificing flexibility.

### Granular access control

Fine-grained, field-level access control defined in code. You can write custom logic for create, read, update, and delete operations per field or per list.

### Fully open source with no vendor lock-in

MIT licensed with no paid tiers or proprietary features gated behind a subscription. You own the entire stack and can host it wherever you want.

## Key pain points

The biggest challenge with KeystoneJS is that it hands you all the responsibility that a managed CMS would normally handle. Deployment is entirely on you, and the documentation around production hosting, Docker configuration, and scaling is thin. We've seen teams struggle to go from a smooth local development experience to a reliable production setup, especially if they don't have dedicated DevOps support. The admin UI Docker image alone can balloon to over a gigabyte, which is a headache for containerised deployments.

The community around Keystone is significantly smaller than competitors like Strapi or Payload. That means fewer tutorials, fewer plugins, and slower answers when you hit an edge case. The ecosystem of ready-made integrations is almost non-existent, so you'll be building most things from scratch. For an agency working on client projects with deadlines, that time cost adds up quickly.

Content editors also tend to have a harder time with Keystone compared to more polished alternatives. The admin UI is functional but feels utilitarian, and non-technical users often need more onboarding than you'd expect. There's no visual editing, no preview infrastructure, and no real content workflow features like drafts, publishing schedules, or approval chains without building them yourself. If your client's content team needs a CMS they can pick up and run with, Keystone usually isn't the answer.

### Deployment complexity

Self-hosting is the only option, and the docs don't hold your hand. Getting Keystone into production requires real infrastructure knowledge, and the large Docker image sizes make it worse.

### Small community and ecosystem

Compared to Strapi or even Payload, the community is much smaller. Fewer plugins, fewer tutorials, and slower support when things go wrong.

### No built-in content workflows

There are no turnkey drafts, scheduled publishing, or approval chains. Keystone provides field primitives that can be assembled into publishing workflows, but you need to wire them up yourself.

### Admin UI feels dated

The admin panel is functional but lacks the polish and UX of modern CMS interfaces. Non-technical editors often find it confusing and need more training.

### No visual editing or live preview

There's no way for editors to see content in context before publishing. You'd need to build your own preview infrastructure, which is a significant engineering effort.

### Scaling requires significant effort

Running Keystone under high traffic means managing session stores, reverse proxies, and server resources yourself. It doesn't scale as smoothly as cloud-native CMS alternatives.

## Target: Storyblok

- **Type:** headless
- **Official site:** https://www.storyblok.com
- **Pricing:** https://www.storyblok.com/pricing
- **Last reviewed:** 2026-08-03

## Key advantages

If you've ever tried explaining "headless" to a content team and watched their eyes glaze over, Storyblok is your peace offering. The visual editor is genuinely good: editors see changes on the real page preview instead of filling out abstract field forms.

That's the upside. The downside is that the API lacks a few basics, like fetching child or sibling pages directly, and the tier jumps get steep once you need more locales or seats. If Storyblok is your choice, we can make it work, we know where the rough edges are and how to set it up cleanly.

### Visual editing capabilities

Yes, you read that right, you can do real-time, on-page editing. Make a change, see it instantly, no staging limbo, which means you can stop "guess and publish."

### Component-based approach

You can build a component once and use it everywhere. You can also update a button or banner in one place, and the entire site fixes itself.

### Efficient content structuring

Your content stays clean, organised, reusable, and not scattered across 40 pages. Developers work with structured data, editors drag-and-drop pieces like Lego. Everyone gets to stay sane.

### Strong multi-language support

One CMS, many languages, no chaos. Localise content without duplicate pages or messy spreadsheet exports.

### Collaborative environment

Writers, designers, and editors can all jump in at the same time without breaking each other’s work. Add comments and approvals. View version histories for teamwork without the headache.

### Highly customisable

If your design system can imagine it, you can use Storyblok to model it. There are custom fields, workflows, and logics that can bend to your stack rather than the other way around.

## Key pain points

Storyblok is not our first recommendation for a headless CMS. The product looks polished, but documentation sprawl makes initial setup harder than it should be, and non-technical editors routinely get lost navigating spaces, stories, and nested components.

Pricing is the bigger issue. Extra locales are $20/month each, extra seats are $15/month each, and custom roles, SSO, and the GraphQL API are all gated behind the custom-priced Premium and Elite plans. Teams on Growth ($99/month) often end up on Growth Plus ($349/month) not because they want the extra features, but because they hit an API request or locale limit.

You'll also lean on third-party integrations for a lot of ordinary tasks, which means more code paths to maintain. Webhook behaviour has changed between releases without clear deprecation notices. The platform works fine once it's set up. Getting there just takes more engineering than the marketing suggests.

### Customisation can take effort

Storyblok can do almost anything, but sometimes the "how" involves developer time, CLI commands, or manual tweaking. Great control, just not always plug-and-play.

### Some integrations need extra work

For things like CRMs or complex platforms, you’ll likely build the integration instead of installing it. Expect a bit more engineering.

### Slower editing

Real-time previews are great, but large pages or heavy components can load slowly. Occasionally, the editor UI feels less intuitive than the rest of the platform.

### Asset management isn’t perfect

Renaming assets, bulk editing, or cleaning libraries can take longer than expected. It doesn't feel as polished as the rest of the system.

### Permissions are fixed

Roles are predefined. For smaller teams, that’s perfectly fine. Bigger teams may want more granular access controls than Storyblok currently offers.

### Pricing jumps with scale

You get a free tier, but some advanced features sit behind higher plans. It’s worth it for projects if you want to pay more; just something teams should budget for early.

## Frequently asked questions

### What makes migrating from KeystoneJS difficult?

KeystoneJS stores data through Prisma, so the database layer is well-structured and easy to export. The harder part is replacing everything Keystone doesn't give you. Most Keystone projects have custom-built preview systems, publishing workflows, and access control logic that are tightly coupled to the Node.js backend. Rebuilding those features in a new CMS takes planning. We typically budget 4 to 8 weeks for a Keystone migration depending on how much custom infrastructure the team has built around it.

### Why do teams move away from KeystoneJS?

Deployment complexity is the number one reason. Teams love Keystone during local development, then hit a wall getting it reliably into production. The Docker images can balloon past a gigabyte, the docs don't cover production hosting well, and there's no managed hosting option. The small community compounds this problem. When you hit an edge case, there are fewer people who've solved it before. Content editors also struggle with the admin UI, which lacks visual editing, live preview, and built-in publishing workflows that competing platforms ship by default.

### How do we extract our content from KeystoneJS?

Since Keystone uses Prisma ORM, your content lives in standard PostgreSQL, MySQL, or SQLite tables with clean schemas. You can export directly from the database using SQL dumps or Prisma's query API. The content model is defined in your TypeScript codebase, so mapping fields to a new CMS is straightforward. We write automated scripts that handle the data transformation, including resolving relationships between lists and migrating file references. For a project with 20 to 50 Keystone lists, extraction and transformation usually takes 1 to 2 weeks.

### How much does Storyblok cost?

Storyblok's Starter plan is $0 with 1 seat, 2 locales, 100K API requests, and 100GB of traffic. Growth is $99/month for 5 seats, 2 locales, 1M API requests, and 400GB. Growth Plus is $349/month for 15 seats, 10 locales, 4M API requests, and 1TB. Add-ons run $15/month per extra seat, $20/month per extra locale, $10 per extra 1M requests, and $75 per extra 250GB. Premium and Elite are custom-priced and gate SSO, custom roles, and the GraphQL API. The catch most teams hit is the gap between tiers, because there's no gradual scaling. A Growth account that runs over on traffic or locales jumps straight to $349/month, a 3.5x increase for what's often a small overage.

### Does Storyblok have a visual editor?

Yes, and it's one of the best in the headless CMS space. You see real-time changes as you edit, directly on your site preview. It's the main reason many teams pick Storyblok. That said, Sanity now offers a comparable experience through its Presentation tool, which gives you live visual editing with more flexibility in content modelling. If the visual editor is your primary reason for choosing Storyblok, it's worth comparing both before committing.