Case Study
View Case StudyTray.ai
Migrating hundreds of thousands of pages, re-platforming and extending for the leading composable AI integration platform
From Agility CMS to KeystoneJS
We are the Agility CMS to KeystoneJS migration experts
Last verified:
Challenges with Agility CMS
Key pain points
The pricing is the elephant in the room. Starting at $1,249/month for the lowest tier, Agility is significantly more expensive than most headless CMS competitors. For smaller agencies or startups, that's a hard sell when platforms like Sanity or Contentful offer free tiers and more gradual scaling. If a client needs template customizations beyond what's available, those changes often require going through Agility's team at additional cost, which can slow things down.
The editor experience, while better than most headless CMS tools, still has rough edges. The content preview has a noticeable delay which frustrates editors used to real-time feedback. Component nesting can feel limited when building complex layouts, and creating unique page designs sometimes requires creating an excessive number of components as workarounds. The initial setup and configuration is also more involved than the marketing suggests, particularly for teams coming from traditional CMS platforms.
The ecosystem and community are noticeably smaller than competitors like Contentful or Sanity. There's less community-generated content, fewer third-party plugins, and Stack Overflow coverage is thin. When you hit an edge case, you're more reliant on the support team than community knowledge. The platform also lacks JSON field support in content models, which limits some advanced use cases that other headless CMS tools handle natively.
Expensive entry point
Starting at $1,249/month with no free tier, it's one of the priciest headless CMS options. Hard to justify for smaller projects or clients with lean budgets.
Slow content preview
The preview function has a noticeable delay before changes appear, making it less immediate compared to tools like Sanity or Storyblok that offer real-time feedback.
Steep initial setup
Despite marketing claims of simplicity, the initial configuration requires significant effort. Advanced features and custom setups demand real technical expertise.
Limited component nesting
Building complex, deeply nested layouts can feel restrictive. You often end up creating numerous individual components as workarounds for unique page designs.
Small community and ecosystem
Far fewer plugins, community resources, and Stack Overflow answers compared to Contentful or Sanity. When you hit edge cases, you're mostly on your own.
Missing JSON field support
No native JSON datatype in content models, which limits flexibility for advanced structured data use cases that other headless CMS platforms handle easily.
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
Agility CMS to KeystoneJS migration FAQs
Answers to the most common questions about Agility CMS to KeystoneJS migration
How do we migrate away from Agility CMS?
Agility CMS content is accessible through their REST API, so extracting pages, content lists, and media is doable with scripted API calls. The trickier part is the page management layer. Agility's built-in sitemap and page routing don't have direct equivalents in most headless CMS platforms, so that logic needs to be rebuilt in your frontend. We typically budget 4 to 8 weeks for Agility migrations depending on how deeply the page management features are used.
Is Agility CMS worth the price?
At $1,249/month minimum with no free tier, Agility is one of the priciest headless CMS options available. For teams that genuinely need built-in page management, SEO tools, and generous API limits, the cost can be justified. But most mid-sized teams we work with find they can get the same results with a platform like Sanity at a fraction of the cost, especially when you factor in Agility's additional charges for template customisations that go beyond their standard offerings.
What are the biggest risks of staying on Agility CMS?
The small ecosystem is the long-term concern. With fewer community resources, plugins, and Stack Overflow coverage than competitors, you're heavily reliant on Agility's support team for edge cases. The preview delay frustrates editors who are used to real-time feedback, and component nesting limitations force workarounds as your design system grows. If Agility ever changes pricing or direction, the limited community means fewer migration guides and less shared knowledge to help you move.
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
