Case Study
View Case StudyTray.ai
Migrating hundreds of thousands of pages, re-platforming and extending for the leading composable AI integration platform
From Directus to Hygraph
We are the Directus to Hygraph migration experts
Last verified:
Challenges with Directus
Key pain points
Directus looks fantastic in demos, but things get rocky once you actually try to use it at scale. The Professional cloud plan is $99/month and caps you at 5 users, 75,000 database entries, and 250,000 API requests — grow past any of those limits and you're straight into custom Enterprise territory. The v12 move to the Monospace Sustainable Core License (MSCL) has also rattled the community; smaller orgs get a free Innovation Grant, but larger teams are navigating a licensing landscape that changed significantly from what they signed up for.
On the dev side, updates can introduce breaking changes, the documentation doesn't always keep pace, and the extension ecosystem is pretty thin. Localization is technically supported but fiddly and easy to misconfigure, and large datasets make the UI noticeably sluggish. And if you want anything deeply custom, you're suddenly living in Vue.js land, which is not where most teams want to spend their weekends.
Breaking update changes
Directus explicitly does not follow semver — any release may include breaking changes. The v10 to v11 upgrade hit schema changes and dropped fields, and the v11 UI scale change (px to rem) broke extensions hardcoding pixel values. Plan your upgrade windows carefully.
Limited extension ecosystem
The plugin ecosystem is still pretty bare. Anything even mildly niche ends up becoming a "let's just custom build it" moment, which defeats the purpose of picking a CMS with extensions. The marketplace launched in beta in early 2024 and is still maturing.
Complex localization setup
Yes, it supports multilingual content, but setting it up feels like assembling IKEA furniture blindfolded. It works, but expect extra config, extra steps, and extra patience.
Version history still tier-gated
Global draft versions now ship automatically with every versioned item — no manual setup required as of March 2026 — which is a genuine improvement. Full version history, rollbacks, and controlled releases are still locked behind higher-tier plans, though, so if predictable publishing workflows are a must, check your tier carefully before committing.
Vue.js knowledge requirement
Custom interfaces and deeper tweaks need Vue.js, so if your team only speaks React, prepare for a small identity crisis (or a hiring plan).
Large dataset performance issues
Heavy tables and deeply relational data can slow down queries and the UI — community reports show 25K-row datasets where raw SQL runs in milliseconds but the Directus API takes 20+ seconds, largely due to internal query overhead and no auto-indexes on foreign keys.
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
Directus to Hygraph migration FAQs
Answers to the most common questions about Directus to Hygraph migration
How do we migrate content out of Directus?
Directus sits directly on your SQL database, which is both a blessing and a curse during migration. The blessing is that your content is in standard PostgreSQL, MySQL, or SQLite tables, so extraction is as simple as SQL queries. The curse is that Directus stores relational data and file references in its own conventions, so you need to untangle junction tables and re-map asset URLs. We write custom migration scripts for each project. A typical Directus migration with 50 to 100 content types takes 3 to 5 weeks.
Why do teams move away from Directus?
The two biggest triggers we see right now are licensing uncertainty and pricing sticker shock. Directus moved to the Monospace Sustainable Core License (MSCL) with v12 in May 2026, replacing the old BSL. Organisations under $5M revenue and 50 employees get a free Innovation Grant, but even above those thresholds the MSCL still permits free use of the Core tier — so larger orgs aren't categorically forced onto paid plans, though many opt into the cloud or a commercial self-hosted license for the production features sitting outside Core, and the community is noticeably split, with some teams forking old versions or migrating off entirely. On the cloud side, the old unlimited tier is gone; the Professional plan is $99/month and caps you at 5 users, 75K database entries, and 250K API requests. Growth past those limits means a jump straight to custom Enterprise pricing. On the development side, any custom interface work still requires Vue.js, which creates friction for React-focused teams. Breaking changes between updates also erode trust over time. Teams that started with Directus for its open-source appeal often outgrow it when they need predictable pricing and cleaner editorial workflows.
Can we keep our existing database when migrating from Directus?
You can keep your database infrastructure, but you'll likely restructure the schema. Directus creates its own system tables (directus_users, directus_permissions, directus_files, etc.) alongside your content tables. During migration, we extract the content tables, transform the data to fit your new CMS's content model, and leave the Directus system tables behind. If you're moving to a headless CMS like Sanity, the data moves from SQL rows to structured JSON documents, which typically results in a cleaner content model.
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
