Case Study
View Case StudyTray.ai
Migrating hundreds of thousands of pages, re-platforming and extending for the leading composable AI integration platform
From Craft CMS to Hygraph
We are the Craft CMS to Hygraph migration experts
Last verified:
Challenges with Craft CMS
Key pain points
The elephant in the room is PHP. Craft requires a traditional LAMP-style hosting setup with PHP 8.2+ and MySQL or Postgres, which immediately rules out the serverless and edge-first hosting that modern JavaScript frameworks thrive on. You're managing servers, configuring OPcache, tuning database connections, and dealing with all the operational overhead that comes with self-hosted PHP applications. For teams already working in the JavaScript ecosystem, this is a hard sell.
Major version upgrades are genuinely painful. Craft doesn't support skipping major versions, so migrating from Craft 2 to 5 means stepping through every version in between. Each jump brings breaking changes to Twig templates, PHP requirements, and plugin compatibility. We've seen agencies spend weeks on upgrades that should have been straightforward. The Team tier starts at $279 per project and the Pro tier costs $399, plus $99 annual renewals for both. A free Solo tier exists for single-user projects, but costs still add up for agencies, especially when you factor in plugins and the recent trend toward stricter licence enforcement in the control panel.
The community, while passionate, is relatively small compared to WordPress or even newer headless CMS platforms. When you hit an edge case or need help with a niche plugin, you may find yourself digging through GitHub issues rather than finding a ready answer. And while Craft Cloud exists as a managed hosting option, it's still maturing and doesn't yet match the deployment experience you'd get with platforms like Vercel or Netlify.
PHP hosting requirements
You need a traditional server with PHP 8.2+, MySQL or Postgres, and proper configuration. No serverless, no edge deployment, no modern hosting shortcuts.
Painful major version upgrades
You can't skip major versions, so upgrades mean stepping through each release with breaking Twig, PHP, and plugin changes along the way.
Smaller community and ecosystem
The community is dedicated but small. Finding answers to niche problems often means digging through GitHub issues or waiting on forum responses.
Licence costs add up
The Team tier is $279 per project and Pro is $399, both with $99 annual renewals, plus paid plugins on top. A free Solo tier exists for single-user projects, but costs add up quickly for agencies managing multiple client sites.
Learning curve for non-developers
Craft assumes your team includes developers. Content editors coming from WordPress or simpler tools will need time to adjust to the more structured interface.
Twig templating limitations
Twig is clean but limited compared to modern component frameworks. Complex UI logic gets awkward, and you're locked into whatever Twig version Craft supports.
Benefits of Hygraph
Key advantages
Hygraph's GraphQL-first setup isn't a gimmick. Queries are precise, you only fetch what you need, and the schema is generated from your content model automatically. Content teams get a clean UI, and developers get proper typing out of the box.
The standout feature is Content Federation: you can pull external REST or GraphQL APIs into Hygraph and query them alongside your content through a single endpoint. That replaces a lot of duct-taped backend glue. Workflows, localization, roles, and staging all come built in.
If you're weighing it up (or trying to untangle an existing setup), talk to us, we've shipped several Hygraph builds and know where the edges are.
GraphQL-first API architecture
Hygraph gives developers precise and predictable queries without over-fetching or duct-taping endpoints. If you're comfortable with GraphQL, go ahead with it.
Multi-region content delivery
Your content gets served from the closest region, so pages load fast everywhere without you having to think about infrastructure.
Fast geo-distributed responses
Because their CDN actually does its job, API calls resolve quickly across regions which is perfect for apps that can’t afford to wait on slow round-trips.
External API integration support
Hygraph’s content federation lets you pull in data from other APIs and treat everything like one unified system without any custom backend glue or microservice jungle.
Generous free tier offering
You can build real projects without paying a penny. It’s surprisingly capable for prototyping, small sites, or testing before you commit budget.
Automated webhook capabilities
All the updates trigger instantly with clean webhooks, which is great for syncing builds, triggering workflows, or piping data into other systems without manual overhead.
Common questions
Craft CMS to Hygraph migration FAQs
Answers to the most common questions about Craft CMS to Hygraph migration
How much does Craft CMS cost for an agency managing multiple sites?
The costs add up quicker than most agencies expect. The Solo tier is free for single-user projects, Team is $279 per project, and Pro is $399 per project. Both paid tiers carry a $99 annual renewal fee. If you're running 10 client sites on Pro, that's $3,990 upfront plus $990 per year in renewals before you've paid for a single plugin. Popular plugins like SEOmatic, Blitz (caching), and Navigation run $99-$199 each. Factor in PHP hosting ($20-$100/month per site depending on traffic) and the total per-project cost lands between $500 and $1,500 in year one. It's reasonable for individual projects but the aggregate cost across a portfolio is where agencies feel the squeeze.
What are the hidden costs of running Craft CMS?
Beyond licensing, three costs catch teams off guard. First, PHP hosting. Craft needs PHP 8.2+, MySQL or Postgres, and proper server configuration. You can't deploy to Vercel or Netlify like you would with a headless CMS. Budget $20-$100/month per site for decent managed hosting. Second, major version upgrades. Craft doesn't let you skip versions, so going from Craft 3 to 5 means stepping through 3 to 4, then 4 to 5, each with breaking changes to Twig templates and plugin compatibility. We've seen agencies spend 20-40 hours per upgrade. Third, developer dependency. Craft assumes your team has PHP developers on hand. If your agency is moving toward JavaScript stacks, maintaining Craft expertise becomes an overhead.
Should I migrate from Craft CMS to a headless CMS?
It depends on your stack direction. If your team is comfortable with PHP and Twig, and your sites are traditional server-rendered builds, Craft still works well. But if you're building with Next.js, React, or any modern JavaScript framework, Craft becomes friction. Its GraphQL API exists but it's a bolt-on, not a native experience. The content modelling in Craft is genuinely good, and that translates well to headless platforms. We've migrated Craft sites to Sanity where the content structures mapped over almost one-to-one. The frontend rebuild in Next.js typically takes 6-10 weeks, and the result is faster, cheaper to host, and easier to iterate on.
What's the biggest challenge when migrating off Craft CMS?
Twig templates. Every piece of frontend logic in a Craft project lives in Twig, and none of it carries over to a modern JavaScript framework. You're essentially rebuilding every template from scratch. Content migration itself is manageable since Craft's data structures are well-organised, and you can export through the Element API or direct database queries. The other challenge is plugin replacement. If you rely on Craft plugins for forms, SEO, or search, you need to find equivalents in your new stack. We build a dependency audit before any Craft migration so there are no surprises mid-project.
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. Overages on Growth are $0.20 per 10,000 API operations. Enterprise is custom pricing and typically unlocks 200+ seats, 1M+ entries, 50M+ API operations, up to 80 locales, plus SSO and dedicated infrastructure. The catch is the same as it has always been, high-traffic sites burn through included operations fast, and Content Federation queries count against your limits too. Model your expected API usage before committing.
What's the hardest part of migrating from Hygraph?
Content extraction is actually straightforward since everything comes out through GraphQL queries. The harder part is rebuilding whatever Content Federation layer you've set up, because that logic lives inside Hygraph and doesn't export. If you've wired up three or four external APIs through federation, you'll need to replicate those integrations in your application layer. The other pain point is schema translation. Hygraph's content model maps to GraphQL types, and converting those to another CMS's schema (especially one that uses GROQ or REST) takes careful planning. We typically budget 4-8 weeks for a Hygraph migration depending on content volume and federation complexity.
Get in touch
Fill out the form below and we'll get back to you
