Case study
View case studySlingshot Bio
Roboto converged Slingshot Bio's WordPress and Shopify sites into one headless Shopify build on Next.js and Sanity, instrumented end to end and AI-ready.
From Hygraph to KeystoneJS
We are the Hygraph to KeystoneJS migration experts
Last verified:
Challenges with Hygraph
Key pain points
GraphQL-only is the core trade-off. If your team hasn't worked with GraphQL, expect a ramp-up period, and simple projects can end up feeling more complex than they need to be. The UI slows down once your dataset grows, especially with dozens of fields or multiple locales. Localization works, but past ten languages the interface starts to feel like a spreadsheet that lost a fight.
Integrations take more effort if the rest of your stack is REST. There's no REST endpoint, so you'll write adapters or a BFF layer. Pricing is the other thing to plan for. The Growth plan at $199/month includes 1M API operations, and metered overages stack up quickly on a busy site once you cross that line. Enterprise is the only way to unlock SSO, custom roles, and higher locale counts.
If you're unsure whether Hygraph is the right fit, or you're stuck halfway up the learning curve, reach out. We can help you map the cleanest path forward.
You have to really love GraphQL
GraphQL is one of its strongest point but it can be your downfall as well, if your team hasn’t touched GraphQL before, expect a ramp-up period. It’s powerful but definitely not “plug in and go.”
Large dataset performance issues
Once your project grows, the Hygraph UI can start dragging. Big data collections need extra optimization to stay usable.
Interface sluggishness at scale
Heavy models, long lists, and asset-heavy projects can make the dashboard feel slow, especially for editors.
Localization workflow complexity
Managing multiple locales works, but it’s not as intuitive as it looks on paper. Some teams find themselves clicking around more than expected.
Multi-language interface clutter
Multi-language setups work fine, but as soon as you hit double-digit locales, the UI quickly becomes noisy and harder to manage. It’s usable, just not optimised for scale.
REST API integration challenges
If your systems still rely on REST, be prepared for extra engineering. Hygraph is GraphQL-only, so adapters and rework are part of the deal.
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
Hygraph to KeystoneJS migration FAQs
Answers to the most common questions about Hygraph to KeystoneJS migration
Is Hygraph easy for non-technical editors to use?
It's decent but not great. Hygraph's editor UI is clean and approachable for basic content updates, but the moment your content model gets complex (nested components, multiple locales, lots of reference fields), editors start feeling overwhelmed. The interface slows down with large datasets, and the GraphQL-native approach means the editorial experience is shaped by developer decisions more than in other headless CMS platforms. We've set up Hygraph for teams where editors managed well after proper onboarding, but it requires more hand-holding than something like Sanity's Studio, which was designed with editorial experience as a first-class priority.
How does Hygraph compare to other headless CMS options?
Hygraph's standout feature is Content Federation, which lets you pull data from external APIs into a unified GraphQL layer. That's genuinely useful if you're aggregating content from multiple sources. Compared to Contentful, Hygraph is cheaper at the lower tiers and more developer-friendly if your team already knows GraphQL. Compared to Sanity, Hygraph offers less flexibility in content modelling and lacks real-time collaboration in the editor. The free tier is generous for small projects. For larger builds, we usually recommend Sanity because the customisation ceiling is much higher and you're not locked into GraphQL as your only query language.
What does Hygraph cost as you scale?
Hygraph's Hobby plan is free with 3 seats, 1,000 content entries, 500K API operations, and 2 locales. The Growth plan is $199/month with 10 seats, 10,000 entries, 1M API operations, and 3 locales. Once you pass those limits, Growth charges automatic overages per block of API operations and per GB of asset traffic, so check the current rate on the pricing page before you sign. Enterprise is custom pricing and goes up to 200 seats, 1M+ entries, 50M+ API operations, and up to 80 locales, with SSO and custom roles on top. The catch is the same as it has always been. High-traffic sites burn through included operations fast, and Content Federation queries count against the limit too. Model your expected API usage before committing.
What are Hygraph's main limitations?
Three things come up on real projects. GraphQL is mandatory. There's no REST endpoint, so a REST-heavy stack means writing adapters or a BFF layer, and a team that hasn't used GraphQL faces a real ramp-up. The editor UI slows down as content grows. Big collections, dozens of fields, and double-digit locale counts make the dashboard sluggish for editors. And the paywall sits in awkward places. SSO, custom roles, and higher locale limits only arrive on Enterprise, so a mid-size team that wants proper access control jumps straight from $199/month to a sales call. None of these are dealbreakers if GraphQL is already your default and your content model stays disciplined, but they catch teams who picked Hygraph for the free tier and grew into the constraints.
Can I migrate from Hygraph to Sanity?
Yes, and we do it regularly. Content extraction is the easy part since everything comes out through GraphQL queries. The bigger jobs are two. First, schema translation. Hygraph's content model maps to GraphQL types, and you rewrite those as Sanity schema definitions, then translate every GraphQL query into GROQ on the frontend. The mapping is mechanical once you've done it a few times, but it touches every page that fetches data. Second, rebuilding any Content Federation layer, because that logic lives inside Hygraph and doesn't export. If you've wired three or four external APIs through federation, you replicate those integrations in your application layer. We typically budget 4 to 8 weeks for a Hygraph to Sanity migration depending on content volume and how much federation you're untangling.
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
Tell us what you're building. We reply within one working day — Jono or someone on the team picks up every message personally.
