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 ButterCMS
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.
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.
Book a meeting with us to discuss how we can help or fill out a form to get in touch
Join the growing list of successful migrations
Case Study
View Case StudyMigrating hundreds of thousands of pages, re-platforming and extending for the leading composable AI integration platform

Case Study
View Case StudyFrom Sanity overages to instantaneous publishing, we brought Mario Testino into the fast lane, and did it in style.

Case Study
View Case StudyHelping the UAE's most prolific Pay in 4 merchants scale their design system and composable infrastructure.

Case Study
View Case StudyHow we helped the fastest growing online cycling community, push the editorial velocity to new heights.
