# Directus to Payload migration

> How to migrate from Directus to Payload, with a side-by-side comparison and FAQs.

---

## Source: Directus

- **Type:** headless
- **Official site:** https://directus.io
- **Pricing:** https://directus.io/pricing
- **Last reviewed:** 2026-07-28

## Key advantages

Directus instantly wins points with us because, well… it has a rabbit for a logo. But beyond that, it's genuinely a solid database-first CMS. If you like the idea of a CMS that sits directly on top of your SQL database without any abstractions, Directus feels incredibly natural.

You can self-host it, tweak it endlessly, and treat your schema exactly the way you want. Editors get a no-code admin UI that feels polished, developers get REST and GraphQL out of the box, and teams get workflows, versioning, automations, and proper permission controls. It's flexible, fast, and a great fit if your content is really just structured data waiting for a smarter interface. If your project revolves around relational data and you want total control from database to API, Directus is one of the cleanest ways to build it.

### Intuitive non-technical interface

Editors get a clean, no-code admin panel that feels more like a productivity tool than a CMS. Non-technical teams can handle content updates without pinging developers every five minutes.

### Database-agnostic SQL integration

Directus plugs straight into your SQL database and turns it into an API instantly. If your data lives in Postgres, MySQL, MariaDB, or SQLite, it just works.

### Field-level permission controls

You can lock down every field, table, and action with granular role-based permissions. Perfect for teams that care about security and don't want interns accidentally deleting production data.

### Built-in REST/GraphQL support

Your entire database is instantly exposed as both REST and GraphQL endpoints. Just plug into your frontend and start shipping.

### Extensive UI customization 

Directus lets you tweak the interface, add custom views, tailor layouts, and build the exact editing experience your team needs. It feels like a CMS you can actually shape instead of fight.

### Real-time collaborative editing

Multiple contributors can work in the Studio at the same time without stepping on each other's toes. Collaborative editing shipped in February 2026, so drafts stay clean and the whole workflow feels built for modern teams, not 2010 intranets.

### AI Assistant with image and PDF support

The built-in AI Assistant can process images and PDFs as well as text, and it works across OpenAI, Anthropic, and Google Gemini. It's a genuinely useful addition rather than a feature-list checkbox.

## Key pain points

Directus looks fantastic in demos, but things get rocky once you actually try to use it at scale. The Team cloud plan is $499/month (or $599 billed monthly) and caps you at 10 SSO seats, 50 collections, and 20 flows. Grow past 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.

## Target: Payload

- **Type:** headless
- **Official site:** https://payloadcms.com
- **Pricing:** https://payloadcms.com/enterprise
- **Last reviewed:** 2026-07-28

## Key advantages

Payload is genuinely strong tech. It’s fast, open-source, developer-first, and perfect if you want full control over your content model. The Next.js integration is smooth, the admin UI is clean, and it’s one of the more flexible modern CMS options if your team prefers to build things exactly the way you want them.

Just know that if you want actual features like visual editing, Vercel Blob storage, image handling, etc, you’ll be paying extra for the privilege. If you’re considering Payload or thinking about migrating into (or out of) it, reach out to us. We can help you figure out whether it’s the right stack or guide you toward a cleaner, saner (Sanity) setup.

### Integration with Next.js applications

Payload works natively with Next.js, giving you clean data fetching and a smooth development flow. It removes the usual CMS friction so you can build fast, modern frontends without hacks.

### Fully customizable

Everything is configured in code, which means you can tailor the CMS to your exact use case. You define the logic, workflows, and behaviour.

### Supports custom data models

You can design any content structure your project needs, from simple documents to complex relational models. This gives you full control over how content is organised and delivered.

### Intuitive admin UI

Payload’s admin panel is simple, clean, and fast. Editors can create, update, and manage content without training or digging through confusing menus.

### Custom plugins and APIs

You can extend Payload however you like. Build custom fields, integrate external services, or add your own API routes. Perfect for teams that need deeper project-specific functionality.

### Built-in authentication

Payload comes with user auth, roles, and access control baked in. No external auth service needed, and you can customise permissions to match your editorial workflow.

## Key pain points

Payload’s biggest issue is how quickly it hands you the responsibility baton. Because it leans so heavily on self-hosting, you’re suddenly running databases, managing infra, dealing with scaling, and debugging auth quirks at 11 pm. And since the platform is still maturing, updates can feel unpredictable, and the surrounding ecosystem isn’t quite deep enough yet to soften the landing when something breaks. The recent Figma acquisition didn’t help either. Support has felt a bit lighter, and some priorities clearly shifted, alongside pricing.

Payload feels flexible on day one, the moment your project grows you’re either engineering around gaps or paying more than expected. If you're debating whether Payload fits the future of your stack (or you’re already feeling the cracks), we’re always happy to help you plan a cleaner path or a migration that won’t come back to bite you.

### Steep learning curve

Payload’s code-first approach means you need solid dev experience to use it effectively. Non-technical teams will struggle, and onboarding takes longer compared to more guided CMSs.

### Smaller ecosystem of plugins

There aren’t many ready-made extensions, so you’ll end up building features yourself. This adds development time and increases long-term maintenance.

### Potential performance overhead

Because it’s a full JavaScript backend, Payload can get resource-heavy under high traffic. You’ll need to optimise your server setup and monitor performance more closely.

### Gaps in documentation

The docs are improving, but there are still missing pieces and unclear sections. New users often have to dig through GitHub issues to find answers.

### Small community

The community is growing but still small, so there’s less shared knowledge, fewer tutorials, and slower troubleshooting compared to bigger CMS ecosystems.

### Requires separate hosting

Payload doesn’t come with built-in hosting, so you’re responsible for setting up and managing your server. That adds extra cost, extra setup, and extra operational overhead.

## Frequently asked questions

### 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.