Case Study
View Case StudyTray.ai
Migrating hundreds of thousands of pages, re-platforming and extending for the leading composable AI integration platform
From KeystoneJS to Contentful
We are the KeystoneJS to Contentful migration experts
Last verified:
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.
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.
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.
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
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
Editors enjoy using it. Clean UI, quick search, structured fields, and no “where does this go again?” confusion.
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.
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
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
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 Contentful cost?
Contentful has a Free tier with 10 users, 100K API calls per month, 25 content types, and 10,000 records. The Lite plan is $300/month for 20 users, 1M API calls, and 100GB CDN bandwidth. Premium is custom pricing with unlimited API calls and a 99.99% uptime SLA. We've seen teams hit the free tier's API ceiling or content type cap fast, and the jump to Lite is often forced by a single limit rather than a feature need.
What are some alternatives to Contentful?
Sanity is the alternative we recommend most. It gives you real-time collaboration, a customizable studio, and pay-as-you-go pricing that doesn't punish you for scaling. Storyblok is worth considering if your editors want a visual builder. We've migrated teams off Contentful to both, and Sanity consistently gets the best feedback from developers and content editors alike.
How does Contentful compare to Sanity on pricing?
Contentful charges $300/month for its Lite plan with hard caps on API calls, seats, and content types. Sanity's pricing is usage-based, starting free and scaling with actual consumption. For most mid-size projects, Sanity ends up significantly cheaper. The real difference is that Sanity doesn't gate core features behind premium tiers the way Contentful does with roles, SSO, and content modelling limits.
Can I migrate from Contentful to Sanity?
Yes. We've migrated dozens of Contentful projects to Sanity. The structured content model in Contentful maps well to Sanity's schema, so most migrations are straightforward. Content, assets, references, and localized fields all transfer. Our typical migration takes 2-4 weeks depending on the number of content types and the complexity of your references. We handle frontend rewiring too if you're on Next.js or a similar framework.
Is Contentful good for large enterprise websites?
It can be, but the costs get steep. Enterprise plans are custom-priced and often land in the $50,000-$100,000+ per year range. If you have deep pockets and your team already knows the platform, it works. If you're evaluating from scratch, we'd push you toward Sanity for enterprise use. You get equivalent API performance, better real-time editing, and a pricing model that doesn't penalize growth.
Get in touch
Fill out the form below and we'll get back to you
