Case Study
View Case StudyTray.ai
Migrating hundreds of thousands of pages, re-platforming and extending for the leading composable AI integration platform
From ButterCMS to KeystoneJS
We are the ButterCMS to KeystoneJS migration experts
Last verified:
Challenges with ButterCMS
Key pain points
Where ButterCMS starts to show cracks is when projects grow beyond its comfort zone. The content modeling is adequate for straightforward use cases, but it lacks the depth and flexibility of platforms like Sanity or Contentful. Components are only available for pages, not collections or blog posts, which creates frustrating inconsistencies when you're trying to build a cohesive content architecture. The 1,000 content field limit, even on expensive plans, can become a real ceiling for ambitious projects.
The platform's smaller ecosystem is a double-edged sword. While anyone who knows JavaScript can work with the API, you won't find the same depth of community resources, plugins, or third-party integrations that larger platforms offer. Media management is also noticeably behind, with no bulk upload capability and limited asset organisation tools. For agencies managing multiple client sites, these paper cuts add up quickly.
There have also been transparency concerns. In 2024, a DNS incident affected thousands of sites using ButterCMS, but their status page showed no downtime. That kind of communication gap is a red flag for any team relying on a third-party CMS in production. The pricing, while competitive on the surface, can feel steep for smaller teams once you move past the limited free tier, and the jump between plans isn't always proportional to what you get.
Limited content modeling flexibility
Components are only available for pages, not collections or blog posts. This creates awkward workarounds when you need consistent structured content across different content types.
Content field limits on all plans
Even the most expensive plans cap you at 1,000 content fields. For complex, multi-locale projects this ceiling arrives faster than you'd expect.
No bulk media upload
The media library only supports single-file uploads with limited organisation tools. Managing assets across a large site becomes tedious quickly.
Small ecosystem and community
Compared to Contentful or Sanity, the community is tiny. Fewer plugins, fewer tutorials, and fewer developers with direct experience means more problem-solving on your own.
Transparency concerns around incidents
In 2024, a DNS incident reportedly affected sites using ButterCMS, but limited public acknowledgement on their status page raised concerns about transparency. The details are difficult to verify independently.
Pricing jumps between tiers
The free tier is very limited, and paid plans start at $71 per month. For small projects or startups, the cost can be hard to justify when alternatives offer more generous free tiers.
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
ButterCMS to KeystoneJS migration FAQs
Answers to the most common questions about ButterCMS to KeystoneJS migration
How do we migrate content out of ButterCMS?
ButterCMS has a clean REST API, so pulling your content is straightforward. Blog posts, pages, and collections all export as JSON through their API endpoints. The main complexity is restructuring component-based page content for your target CMS, since ButterCMS components only work on pages and don't map 1:1 to other platforms. Media assets need to be downloaded from their CDN and re-uploaded. For a typical blog-heavy site with 200 to 500 posts, we complete the migration in 2 to 4 weeks.
Why do teams leave ButterCMS?
Content modeling flexibility is the top reason. Once projects grow past simple blogs and marketing pages, the 1,000 content field limit becomes a real ceiling. Components being restricted to pages (not collections or blog posts) forces awkward workarounds. Teams also feel the ecosystem gap, with fewer plugins, integrations, and community resources compared to larger platforms. The 2024 DNS incident that wasn't reflected on their status page raised trust concerns for teams running production sites.
What does ButterCMS cost compared to alternatives?
ButterCMS paid plans start at $71/month after a limited free tier. Every plan includes unlimited users, which is genuinely competitive. But the pricing jumps between tiers aren't proportional to what you get, and the content field limits apply even on expensive plans. By comparison, Sanity's free tier includes 3 users with 500K API requests, and you only pay more as your usage scales. For teams outgrowing ButterCMS, the cost of migration typically pays for itself within 6 months through better tooling and fewer workarounds.
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
