Skip to content




KeystoneJS logo
Contentful logo

From KeystoneJS to Contentful

We are the KeystoneJS to Contentful migration experts

Last verified:


The process

How we migrate from KeystoneJS to Contentful

  1. 01

    Access and gating audit

    First we check the existing KeystoneJS and see whether the data is clean enough to move straight over to Contentful, and plan around any auth walls or bot protection in the way.

  2. 02

    Rendering assessment and extraction

    Then we work out how KeystoneJS renders its pages and pull the content out, even without CMS access.

  3. 03

    AI-assisted sanitization

    Everything extracted runs through our sanitization pipeline, which flags slop, normalizes structure, and leaves us clean content to work with.

  4. 04

    Content-model design with the client

    Before anything moves, we agree the Contentful content model with you, shaped around how your editors actually work.

  5. 05

    Transform and soft-migrate

    We transform the content to the agreed schema and run a full dry run, so mappings and edge cases prove out before production.

  6. 06

    Execute the real migration

    Once the dry run is clean, everything moves into Contentful in one controlled cutover.

  7. 07

    Redirect mapping and throttled sitemap submission

    Every old URL gets mapped to its new home with the right redirect, so rankings and link equity survive the move.

  8. 08

    Agentic-browser QA

    Finally, automated browsers sweep the new site for data issues, design regressions, and missing SEO signals.

  9. Ready when you are. We'll bring the moving boxes.Start my migration


Challenges with KeystoneJS

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.

Help me migrate


Deployment complexity in KeystoneJS

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 in KeystoneJS

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 in KeystoneJS

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.

Dated admin UI in KeystoneJS

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 in KeystoneJS

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 challenges in KeystoneJS

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.



Benefits of Contentful

Key advantages

Contentful is one of the most established headless CMS choices, and we still see plenty of customers land on it after a shortlist.

It's built around structured content, so you model fields once and pull them into any front end you like. That means no copy-pasted components scattered across pages. It also has first-party support for A/B testing and personalization through its Studio add-on, which most competitors don't match natively. The app ecosystem covers SEO, translation, validation, and asset management, and editors get live side-by-side preview for content they're working on.

If your team has the budget and the developer resources to model content properly, it's a solid pick.

Start my migration


APIs in Contentful

API-first design

Contentful was built for APIs from day one, which means your content plugs cleanly into apps, websites, and mobile.

Developer-friendly flexibility

Developer-friendly flexibility

Schemas, content models, and references can be tuned however you like. If your stack is anything beyond "cookie-cutter," Contentful won’t get in your way.

User-friendly interface

User-friendly interface

Editors enjoy using it. Clean UI, quick search, structured fields, and no "where does this go again?" confusion.

Extensive integration capabilities

Extensive integration capabilities

Plug in analytics, eCommerce, automation, and translation. Contentful plays nicely with almost anything. And if something isn’t supported yet, you can wire it up yourself without hacking the platform apart.

Contentful is scalable

Scales under traffic

Contentful's global CDN holds up under heavy load. We've run it on sites pushing millions of monthly requests without needing bespoke infrastructure to handle spikes.

Cloud-based architecture Contentful

Cloud-based architecture

You don't have to install, patch, or maintain anything. It’s fast, globally distributed, and always up to date. Your content team can ship from anywhere without a DevOps babysitter.





Common questions

KeystoneJS to Contentful migration FAQs

Answers to the most common questions about KeystoneJS to Contentful migration

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.


The migration is step one. Our Contentful team handles what comes after: builds, integrations and the content model work that keeps the new platform clean.

Contentful development agency


Get in touch

Tell us what you're building. We reply within one working day. Jono or someone on the team picks up every message personally.

By sending this you agree to our privacy policy. We only use your details to reply.