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 ButterCMS
We are the Directus to ButterCMS 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 ButterCMS
Key advantages
ButterCMS is one of those headless CMS platforms that genuinely nails the onboarding experience. We've seen content teams go from zero to confidently building pages and blog posts within a few hours, which is rare in the headless world. The dashboard is clean, the API explorer is thoughtfully designed, and the starter templates for popular frameworks mean developers aren't starting from scratch every time.
From an agency perspective, the standout quality is how little hand-holding editors need after launch. The interface is intuitive enough that marketers can create pages, manage blog content, and handle SEO metadata without constantly pinging the dev team. The built-in blog engine is a genuine differentiator. Most headless CMS platforms treat blogging as an afterthought, but ButterCMS was originally built around it, and it shows in the quality of the authoring experience.
The API performance is consistently fast, and the SDK support across languages like JavaScript, Python, Ruby, and PHP is solid. Their customer support team is also notably responsive and genuinely receptive to feature requests, which is something we don't often see from CMS vendors. For small-to-mid-sized projects where you need a reliable content API without overcomplicating things, ButterCMS delivers.
We'd particularly recommend it for teams that need a polished blog alongside structured page content, and who value simplicity over infinite extensibility. It's a CMS that knows what it is and does that thing well.
Exceptionally easy onboarding
Content teams can be productive within hours, not days. The dashboard is clean and the learning curve is one of the gentlest we've seen in headless CMS land.
Built-in blog engine
Unlike most headless platforms where you have to model blog content from scratch, ButterCMS ships with a purpose-built blog engine that includes categories, tags, authors, and SEO fields out of the box.
Fast and reliable content API
The read API is consistently quick with global CDN delivery. For content-heavy sites, the performance is solid and predictable.
No seat limits on any plan
Every plan includes unlimited users, which is genuinely unusual in this space. You won't get punished for growing your content team.
Responsive customer support
Their support team is quick to respond and genuinely open to feature requests. We've seen roadmap items added based on customer feedback, which builds real trust.
Strong SDK and framework coverage
Official SDKs for JavaScript, Python, Ruby, PHP, and more, plus starter projects for React, Next.js, Vue, Angular, and other frameworks that actually work out of the box.
Common questions
Directus to ButterCMS migration FAQs
Answers to the most common questions about Directus to ButterCMS 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.
How do we migrate content out of ButterCMS?
ButterCMS has a clean REST API, so pulling your content is straightforward. Blog posts, pages, and collections all export as JSON through their API endpoints. The main complexity is restructuring component-based page content for your target CMS, since ButterCMS components only work on pages and don't map 1:1 to other platforms. Media assets need to be downloaded from their CDN and re-uploaded. For a typical blog-heavy site with 200 to 500 posts, we complete the migration in 2 to 4 weeks.
Why do teams leave ButterCMS?
Content modeling flexibility is the top reason. Once projects grow past simple blogs and marketing pages, the 1,000 content field limit becomes a real ceiling. Components being restricted to pages (not collections or blog posts) forces awkward workarounds. Teams also feel the ecosystem gap, with fewer plugins, integrations, and community resources compared to larger platforms. The 2024 DNS incident that wasn't reflected on their status page raised trust concerns for teams running production sites.
What does ButterCMS cost compared to alternatives?
ButterCMS paid plans start at $71/month after a limited free tier. Every plan includes unlimited users, which is genuinely competitive. But the pricing jumps between tiers aren't proportional to what you get, and the content field limits apply even on expensive plans. By comparison, Sanity's free tier includes 3 users with 500K API requests, and you only pay more as your usage scales. For teams outgrowing ButterCMS, the cost of migration typically pays for itself within 6 months through better tooling and fewer workarounds.
Get in touch
Fill out the form below and we'll get back to you
