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 Builder.io
We are the Directus to Builder.io 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 Builder.io
Key advantages
Builder.io occupies a unique spot in the headless CMS landscape. It is not really a traditional headless CMS in the way that Sanity or Contentful are. It is more of a visual page builder with headless capabilities bolted on. That distinction matters because if your marketing team needs to ship landing pages fast without filing Jira tickets, Builder.io genuinely delivers on that promise. The drag-and-drop editor is solid, and the ability to register your own React components so that non-developers can compose pages from your actual design system is a legitimately powerful idea.
Where Builder.io really shines is in bridging the gap between developers and marketing teams. You build the components, register them with Builder, and then hand the keys over. Marketers can assemble pages, run A/B tests, and publish without touching code. For agencies like ours, this means fewer "can you just move this banner" tickets and more time spent on actual engineering work.
The framework support is also genuinely broad. Next.js, React, Angular, Vue, Svelte, Qwik, SolidJS, and React Native all have SDKs. If you are running a modern JavaScript stack, Builder.io probably has an integration for it. The AI features they have been shipping are interesting too, though still early days in terms of real production reliability.
Visual drag-and-drop editor
The visual editor lets non-technical users build and edit pages using your actual codebase components. It is one of the better implementations of visual editing in the headless space.
Custom component registration
Developers can register their own React, Vue, or Angular components so editors drag and drop real design system pieces rather than generic blocks.
A/B testing and personalisation built in
Native experimentation tools let marketing teams run split tests and personalise content without needing a separate optimisation platform.
Broad framework support
SDKs for Next.js, React, Angular, Vue, Svelte, Qwik, SolidJS, and React Native mean you are not locked into a single frontend framework.
Marketing team autonomy
Content and marketing teams can ship landing pages, campaign pages, and promotions independently, which frees up developer time for product work.
Structured and visual content modes
Builder.io supports both structured data models for developer-driven content and visual page building for marketing-driven content, giving teams flexibility in how they work.
Common questions
Directus to Builder.io migration FAQs
Answers to the most common questions about Directus to Builder.io 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.
Can you migrate from Builder.io without losing your page designs?
Yes, but it takes work. Builder.io's visual editor stores page compositions as JSON that references your registered components. Those component registrations are tightly coupled to Builder's SDK, so you can't just export and import elsewhere. What you can preserve is the design itself. We extract the page structures, map them to equivalent components in the new system, and rebuild the composition layer. The visual output stays the same. Typical timeline is 6-10 weeks depending on how many page types and custom components are involved. The biggest time sink is usually recreating A/B test variants and personalisation rules that lived inside Builder's platform.
What does Builder.io actually cost?
Builder.io's free tier gives you 1 user and basic features, which is enough to evaluate but not to run a real project. The Growth plan starts at $49/month and includes more seats and content types. Beyond that, pricing gets opaque. Teams needing roles, scheduling, and higher API limits are pushed toward custom Enterprise plans that typically start in the $500-$1,000/month range. We've heard from freelancers and small agencies who were caught off guard by charges after exceeding limits on the Growth plan. Builder.io also charges per "impression" on higher tiers, which means your costs scale with traffic in ways that aren't always predictable.
How does Builder.io compare to a traditional headless CMS?
Builder.io is a visual page builder first and a CMS second. That distinction matters. If your primary goal is letting marketing teams build landing pages without developer involvement, Builder.io does that well. If you need structured content modelling, editorial workflows, multi-language support, or content that powers more than just web pages, a traditional headless CMS is a better fit. Builder.io's SDK embeds deeply into your frontend code, which creates vendor lock-in that most headless CMS platforms avoid. We typically recommend Builder.io only when the use case is narrow: high-volume landing page creation for marketing teams. For everything else, a headless CMS with a proper content model gives you more flexibility long-term.
What's the main risk of building on Builder.io?
Vendor lock-in. Builder.io's SDKs are woven into your component rendering layer, which means migrating away requires rebuilding how your pages are composed and rendered. That's not a content migration, it's an architecture migration. With a typical headless CMS, your content is accessible through standard APIs and your frontend is independent. With Builder.io, the two are intertwined. We've worked with teams who spent months extracting themselves from Builder.io because every page template needed to be recreated outside the platform. If you're evaluating Builder.io, go in with eyes open about the exit cost.
Get in touch
Fill out the form below and we'll get back to you
