Skip to content




Directus logo
KeystoneJS logo

From Directus to KeystoneJS

We are the Directus to KeystoneJS migration experts

Last verified:


The process

How we migrate from Directus to KeystoneJS

  1. 01

    Access and gating audit

    First we check the existing Directus and see whether the data is clean enough to move straight over to KeystoneJS, and plan around any auth walls or bot protection in the way.

  2. 02

    Rendering assessment and extraction

    Then we work out how Directus renders its pages and pull the content out, even without CMS access.

  3. 03

    AI-assisted sanitization

    Everything extracted runs through our sanitization pipeline, which flags slop, normalizes structure, and leaves us clean content to work with.

  4. 04

    Content-model design with the client

    Before anything moves, we agree the KeystoneJS content model with you, shaped around how your editors actually work.

  5. 05

    Transform and soft-migrate

    We transform the content to the agreed schema and run a full dry run, so mappings and edge cases prove out before production.

  6. 06

    Execute the real migration

    Once the dry run is clean, everything moves into KeystoneJS in one controlled cutover.

  7. 07

    Redirect mapping and throttled sitemap submission

    Every old URL gets mapped to its new home with the right redirect, so rankings and link equity survive the move.

  8. 08

    Agentic-browser QA

    Finally, automated browsers sweep the new site for data issues, design regressions, and missing SEO signals.

  9. Ready when you are. We'll bring the moving boxes.Start my migration


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

Help me migrate


Breaking update changes in Directus

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

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

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 in Directus

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

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

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 KeystoneJS

Key advantages

KeystoneJS is one of those tools that really clicks if your team thinks in code. It's a schema-driven, open-source headless CMS built on Node.js, and the developer experience is genuinely good. You define your content models in TypeScript, Keystone generates a GraphQL API and an admin UI for you, and you're off. There's very little magic or abstraction hiding what's happening under the hood, which we appreciate when building complex projects for clients.

The Prisma ORM integration is a real highlight. Automatic migration generation, type-safe database access, and support for PostgreSQL, MySQL, and SQLite mean you're not fighting your data layer. If you've ever had to wrangle a CMS into supporting a non-trivial relational content model, you'll understand why this matters. Keystone lets you express those relationships cleanly and query them with a proper GraphQL API.

The document field editor is also worth mentioning. It's one of the more thoughtful rich text implementations we've seen in a headless CMS. You can embed custom React components directly into the editor, which means content teams can work with your actual design system components rather than generic blocks. For teams that care about structured content, Keystone gives you real tools to enforce it.

Where Keystone really shines is in projects where the development team wants full ownership of the stack. There's no vendor lock-in, no proprietary query language, and no surprise pricing tiers. If you want a CMS that feels like a well-designed library rather than a platform, Keystone delivers on that promise.

Start my migration


Schema-as-code in KeystoneJS

Schema-as-code with full TypeScript support

Define your entire content model in TypeScript with strong type inference throughout. The schema drives everything from the database to the admin UI to the GraphQL API.

Automatic GraphQL API in KeystoneJS

Automatic GraphQL API generation

Every content type you define automatically gets a full CRUD GraphQL API with filtering, pagination, and relationship resolution. No manual endpoint wiring needed.

Prisma-powered database in KeystoneJS

Prisma-powered database layer

Built on Prisma ORM with automatic migration generation and type-safe queries. Supports PostgreSQL, MySQL, and SQLite out of the box.

Flexible document editor in KeystoneJS

Flexible document field editor

The rich text editor supports custom embedded components that map to your design system, giving content editors structured authoring without sacrificing flexibility.

Granular access control in KeystoneJS

Granular access control

Fine-grained, field-level access control defined in code. You can write custom logic for create, read, update, and delete operations per field or per list.

Open source with no vendor lock-in in KeystoneJS

Fully open source with no vendor lock-in

MIT licensed with no paid tiers or proprietary features gated behind a subscription. You own the entire stack and can host it wherever you want.





Common questions

Directus to KeystoneJS migration FAQs

Answers to the most common questions about Directus to KeystoneJS migration

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.


Get in touch

Tell us what you're building. We reply within one working day. Jono or someone on the team picks up every message personally.

By sending this you agree to our privacy policy. We only use your details to reply.