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 Sanity
We are the Craft CMS to Sanity 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 Sanity
Key advantages
You know where our bias' lies. We think Sanity is literally the best headless content management out there. The schema is code-based, so it can be easily versioned, scaled, and extended without a heap of third-party hoops to jump. Providing you build it with a solid foundation, which we always recommend Turbo Start Sanity, it's going to be the most valuable hub for content you can imagine.
It's got a very unique tooling called the Live Content API, which in simple terms means
when you press publish, its live.
No issues with caching, and a single API usage that scales perfectly with multichannel content delivery.
It also offers one of the best editorial experiences in the industry with Presentation and customizable content structures. We're obviously huge fans of it, and we've pivoted our business with it when we realised how ahead it is.
Real time collaboration
You write, your teammate tags in, adds citations, and updates the same doc without stepping on each other. It’s the fastest way to ship content without the “who has edit access?” chaos.
Live preview block building
With Sanity, you don’t have to guess what your page might look like. Real-time previews update the moment you type. It’s a 1:1 mirror of your site before it ever goes live, so your campaigns look right the first time.
Meta tags, structured content
Sanity’s structured content gives Google clean data and rich schema, so your pages surface higher without manual hacking. Automated schema, smarter metadata, and better rankings.
Better media management
A blazing-fast media library with first-class support for Cloudinary, Mux, Wistia and more. Upload, drag-and-drop, preview without wrestling with assets, and waiting for spins of doom.
Automated social sharing
Ever wanted to share one update, and automatically populate every social platform? Welcome to the future we've built that. Why should social media be a chore.
Automated image generation
Sanity keeps your subject centred and sharp like a tiny author thumbnail or a full-page hero banner. There are no awkward crops, or chopped heads. Your visuals just look right everywhere.
Common questions
Craft CMS to Sanity migration FAQs
Answers to the most common questions about Craft CMS to Sanity 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.
Why should we migrate to Sanity instead of another headless CMS?
Sanity's Live Content API means content goes live the instant you press publish, with zero caching issues. We've migrated teams from WordPress, Contentful, Drupal, and legacy platforms, and the consistent feedback is that the editorial experience is faster and more flexible. The schema-as-code approach means your content model is version-controlled alongside your codebase. Pricing starts free for small teams and scales predictably, unlike platforms that hit you with surprise API overage bills.
What does a migration to Sanity actually involve?
A typical migration has three phases. First, we map your existing content model to a Sanity schema, which usually takes 1 to 2 weeks depending on complexity. Second, we build automated migration scripts that transfer your content, media assets, and relationships. Third, we set up the frontend integration and editorial workflows. For a mid-sized site with 500 to 2,000 pages, the full process usually runs 4 to 8 weeks. We use our Turbo Start Sanity foundation to accelerate the setup so you're not starting from zero.
How long does it take before our content team is productive in Sanity?
Most editors are comfortable within the first week. Sanity's Presentation tool gives them a side-by-side live preview that feels intuitive, especially for teams used to visual page builders. The real-time collaboration means multiple editors can work on the same document without conflicts. We typically run a 2-hour onboarding session and provide a custom guide tailored to your specific content model. After that, editors rarely need developer support for day-to-day publishing.
How much does Sanity cost?
Sanity's Free plan includes 20 user seats, 10,000 documents, 1M CDN API requests, 250K regular API requests, 100GB of assets, and unlimited locales. The Growth plan is $15 per seat/month with 25,000 documents and the same API allowances, plus pay-as-you-go overages and 5 roles including Editor, Developer, and Contributor. Enterprise pricing is custom for organisations that need custom roles, SLAs, or private datasets. Most mid-size teams we work with stay well inside Growth's limits.
Get in touch
Fill out the form below and we'll get back to you
