From Contentful to KeystoneJS

We are the Contentful to KeystoneJS migration experts

Challenges with Contentful

Key pain points

With all good things, there’s a “depends on how you use it and who is using it” clause. Contentful usage-based pricing can quietly snowball, especially for smaller teams or projects running on lean budgets. Its API-first approach might make developers grin, but the non-technical users might find themselves staring at setup screens, wondering, “Wait… where’s the editor?”

More often than not, the main reason Contentful sucks is that the developer has built it incorrectly, as it has a whole host of opinionation that isn't widely known. E.g.

You need to be extremely careful with the number of documents you build, as you could very easily push yourself into enterprise from an early stage.

We'd always recommend speaking to us first, before completely writing it off.

Potentially high costs

Contentful isn’t a cheap CMS. As your traffic, models, or team grows, pricing can climb faster than expected.

Complex for non-technical users

Marketers and editors may need a small learning curve before they feel at home. It’s powerful but not always plug-and-play.

Integration dependency

A lot of magic happens through third-party tools. Great for flexibility, but it does mean extra setup instead of getting everything out-of-the-box.

Limited native features

Contentful keeps the core CMS clean and minimal, but that also means more building and configuring to get advanced functionality.

Learning curve for new teams

If your team is moving from a traditional CMS, expect some onboarding time. Structured content is amazing but new for many.

Requires careful management

Because it’s so flexible, projects need good governance. Without it, content models can get messy and harder to maintain over time.

Benefits of KeystoneJS

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.