Case Study
View Case StudyTray.ai
Migrating hundreds of thousands of pages, re-platforming and extending for the leading composable AI integration platform
From Payload to KeystoneJS
We are the Payload to KeystoneJS migration experts
Last verified:
Challenges with Payload
Key pain points
Payload’s biggest issue is how quickly it hands you the responsibility baton. Because it leans so heavily on self-hosting, you’re suddenly running databases, managing infra, dealing with scaling, and debugging auth quirks at 11 pm. And since the platform is still maturing, updates can feel unpredictable, and the surrounding ecosystem isn’t quite deep enough yet to soften the landing when something breaks. The recent Figma acquisition didn’t help either. Support has felt a bit lighter, and some priorities clearly shifted, alongside pricing.
Payload feels flexible on day one, the moment your project grows you’re either engineering around gaps or paying more than expected. If you're debating whether Payload fits the future of your stack (or you’re already feeling the cracks), we’re always happy to help you plan a cleaner path or a migration that won’t come back to bite you.
Steep learning curve
Payload’s code-first approach means you need solid dev experience to use it effectively. Non-technical teams will struggle, and onboarding takes longer compared to more guided CMSs.
Smaller ecosystem of plugins
There aren’t many ready-made extensions, so you’ll end up building features yourself. This adds development time and increases long-term maintenance.
Potential performance overhead
Because it’s a full JavaScript backend, Payload can get resource-heavy under high traffic. You’ll need to optimise your server setup and monitor performance more closely.
Gaps in documentation
The docs are improving, but there are still missing pieces and unclear sections. New users often have to dig through GitHub issues to find answers.
Small community
The community is growing but still small, so there’s less shared knowledge, fewer tutorials, and slower troubleshooting compared to bigger CMS ecosystems.
Requires separate hosting
Payload doesn’t come with built-in hosting, so you’re responsible for setting up and managing your server. That adds extra cost, extra setup, and extra operational overhead.
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.
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.
Common questions
Payload to KeystoneJS migration FAQs
Answers to the most common questions about Payload to KeystoneJS migration
How hard is it to migrate away from Payload CMS?
Payload stores content in MongoDB or Postgres, so extracting your data is straightforward compared to proprietary platforms. The real work is restructuring your content model for the target CMS and rebuilding any custom access control logic you've written. We typically complete Payload migrations in 3 to 6 weeks depending on how much custom backend logic is involved. The code-first nature of Payload means most of the content model is well-documented in your own codebase, which actually makes migration planning easier.
What are the main reasons teams leave Payload?
The most common reasons we hear are infrastructure fatigue and ecosystem gaps. Payload requires you to manage your own database, hosting, auth, and scaling. Teams that chose Payload for its developer flexibility eventually realise they're spending more time on DevOps than on content features. The Figma acquisition in 2024 also shifted priorities, and some teams feel the platform's direction became less predictable. Visual editing and live preview still require significant custom engineering compared to platforms that ship them natively.
What does a Payload to Sanity migration cost?
For a typical content site with 200 to 1,000 documents, we estimate 4 to 6 weeks of work. The bulk of effort goes into rebuilding the admin experience and frontend integration, not the data transfer itself. Payload's MongoDB exports are clean, so content migration scripts run reliably. The cost depends heavily on how much custom auth logic and access control you've built, since that needs to be rebuilt in the target platform's permission system. We scope every migration individually after reviewing your Payload config.
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.
Get in touch
Fill out the form below and we'll get back to you
