⚠️ Breaking Change
Impact Score: 7/10
Directus v11.6.0 — Release Notes & Engineering Impact
Source available — automated, not human-reviewed
Component: directus · Channel: stable. Automated analysis, not a compatibility certification. How this works.
Analysis updated: 2026-11-01.
Breaking-change evidence from the source
⚠️ Potential Breaking Changes - **@directus/api**
⚡ Executive Summary (TL;DR)
Directus v11.6.0. Source highlight: ⚠️ Potential Breaking Changes
Who Does This Impact? (Role-Based Analysis)
💻 Software Engineers & Devs
Check the source notes against the package and APIs you use before upgrading.
📊 Product & Engineering Leads
Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.
⚙️ DevOps & Security
Verify the target version, runtime requirements and rollback procedure in the official documentation.
⚠️ Breaking Changes & Deprecations (1)
- ⚠️ Potential Breaking Changes - **@directus/api**
✨ New Features & Capabilities (6)
- Added Visual Editor Beta (#24758 by @formfcw)
- After creating a new content version, it will become the current selected version (#24606 by @robluton)
- Added Version support to field rules. This allows conditional rules based on an item's version (#24646 by @robluton)
- Added Visual Editor Beta (#24758 by @formfcw)
- Added the ability to map OAuth claim groups to Directus roles (#24558 by @daanh432)
- Added `omitKey` option to `getConfigFromEnv` (#24826 by @jacobcons)
🔧 Bug Fixes & Patches (6)
- Fixed filter hook altered payload not passed to action hook on `create` (#24812 by @ComfortablyCoding)
- Fix missing \_some,\_none in GQL (#24644 by @Nitwel)
- Version menu positioned next to breadcrumb and remains visible when header is in its compact state once the user (#24778 by @robluton)
- Updated dependencies (#24722 by @renovate)
- Fixed Decimal rounding errors by treating them as strings in app (#24824 by @formfcw)
- Automates the value of the version key field basd on the name field. (#24627 by @robluton)
📄 View Raw Release Notes (Original Developer Log)
### ⚠️ Potential Breaking Changes
- **@directus/api**
- Fixed filter hook altered payload not passed to action hook on `create` ([#24812](https://github.com/directus/directus/pull/24812) by @ComfortablyCoding)
- GraphQL primary key field types have changed from `String` to `ID` ([#24757](https://github.com/directus/directus/pull/24757) by @Nitwel)
### ✨ New Features & Improvements
- **@directus/app**
- Added Visual Editor Beta ([#24758](https://github.com/directus/directus/pull/24758) by @formfcw)
- After creating a new content version, it will become the current selected version ([#24606](https://github.com/directus/directus/pull/24606) by @robluton)
- Added Version support to field rules. This allows conditional rules based on an item's version ([#24646](https://github.com/directus/directus/pull/24646) by @robluton)
- **@directus/api**
- Added Visual Editor Beta ([#24758](https://github.com/directus/directus/pull/24758) by @formfcw)
- Added the ability to map OAuth claim groups to Directus roles ([#24558](https://github.com/directus/directus/pull/24558) by @daanh432)
- Added `omitKey` option to `getConfigFromEnv` ([#24826](https://github.com/directus/directus/pull/24826) by @jacobcons)
- Added support for relational dynamic variables in filters ([#24635](https://github.com/directus/directus/pull/24635) by @Nitwel)
- Added `files.upload` event for resumable uploads ([#24771](https://github.com/directus/directus/pull/24771) by @br41nslug)
- Fix missing \_some,\_none in GQL ([#24644](https://github.com/directus/directus/pull/24644) by @Nitwel)
- Added QUERYSTRING_MAX_PARSE_DEPTH configuration variable ([#24833](https://github.com/directus/directus/pull/24833) by @Nitwel)
- **@directus/env**
- Added QUERYSTRING_MAX_PARSE_DEPTH configuration variable ([#24833](https://github.com/directus/directus/pull/24833) by @Nitwel)
- **@directus/system-data**
- Added Visual Editor Beta ([#24758](https://github.com/directus/directus/pull/24758) by @formfcw)
- **@directus/types**
- Added Visual Editor Beta ([#24758](https://github.com/directus/directus/pull/24758) by @formfcw)
- **@directus/sdk**
- Added an `isDirectusError` type guard function ot improve SDK error handling ([#24764](https://github.com/directus/directus/pull/24764) by @ComfortablyCoding)
### 🐛 Bug Fixes & Optimizations
- **@directus/app**
- Version menu positioned next to breadcrumb and remains visible when header is in its compact state once the user ([#24778](https://github.com/directus/directus/pull/24778) by @robluton)
scrolls.
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- Fixed Decimal rounding errors by treating them as strings in app ([#24824](https://github.com/directus/directus/pull/24824) by @formfcw)
- Automates the value of the version key field basd on the name field. ([#24627](https://github.com/directus/directus/pull/24627) by @robluton)
- Fixed deleting of folder after proper reparenting ([#24845](https://github.com/directus/directus/pull/24845) by @Nitwel)
- Downgraded Editor.JS to circumvent conflicting inline elements bug until it's fixed ([#24851](https://github.com/directus/directus/pull/24851) by @connorwinston)
- Fixed Flow Logs loading all step data when listing logs ([#24809](https://github.com/directus/directus/pull/24809) by @connorwinston)
- Fixed Block Editor Interface clearing field values unintentionally when updating an item. ([#24839](https://github.com/directus/directus/pull/24839) by @connorwinston)
- Updated translation key input field overflow ([#24769](https://github.com/directus/directus/pull/24769) by @ngluunhatson)
- Fixed re-linking new pointer references to existing links ([#24790](https://github.com/directus/directus/pull/24790) by @ComfortablyCoding)
- Fixed the appearance of the code interface when an enclosing group is made visible by a condition ([#24834](https://github.com/directus/directus/pull/24834) by @robluton)
- **@directus/api**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- Fixed subscription throwing an unhandled error if a null query is passed ([#24772](https://github.com/directus/directus/pull/24772) by @ComfortablyCoding)
- Fixed dynamic variables parsing on field validation ([#24634](https://github.com/directus/directus/pull/24634) by @Nitwel)
- Fixed an issue that was caused by improper query binding deduplication needed for groupBy queries ([#24604](https://github.com/directus/directus/pull/24604) by @hanneskuettner)
- Added function to escape strings for use in redaction regex ([#24642](https://github.com/directus/directus/pull/24642) by @br41nslug)
- Improved invalid asset transformation parameter value error handling ([#24817](https://github.com/directus/directus/pull/24817) by @jacobcons)
- Added implicit _some for o2m and m2a relations ([#24725](https://github.com/directus/directus/pull/24725) by @koljam)
- Added path information to Validation errors ([#24751](https://github.com/directus/directus/pull/24751) by @Nitwel)
- Improved error handling for `/utils/hash/verify` endpoint ([#24788](https://github.com/directus/directus/pull/24788) by @Nitwel)
- Fix keys being optional on writes ([#24555](https://github.com/directus/directus/pull/24555) by @Nitwel)
- Fixed singleton type for oas spec ([#24768](https://github.com/directus/directus/pull/24768) by @Nitwel)
- Added error logging for invalid `PUBLIC_URL` on SSO redirection ([#24836](https://github.com/directus/directus/pull/24836) by @licitdev)
- Added id_filter_operators to GQL ([#24757](https://github.com/directus/directus/pull/24757) by @Nitwel)
- Fix insertion of keys in o2m relation ([#24609](https://github.com/directus/directus/pull/24609) by @Nitwel)
- Improved validation checks for `createOne` in the collections service ([#24960](https://github.com/directus/directus/pull/24960) by @Nitwel)
- **@directus/components**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/composables**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/constants**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **create-directus-extension**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **create-directus-project**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/env**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/errors**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/extensions-registry**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/extensions-sdk**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- Updated esbuild to 0.25 ([#24794](https://github.com/directus/directus/pull/24794) by @br41nslug)
- **@directus/extensions**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/format-title**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/memory**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/pressure**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/random**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/release-notes-generator**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/schema**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/storage-driver-azure**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/storage-driver-cloudinary**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/storage-driver-gcs**
- Updated dependencies ([#24722](https://github.com/directus/directus/pull/24722) by @renovate)
- **@directus/validation**
- Added path information to Validation errors ([#24751](https://github.com/directus/directus/pull/24751) by @Nitwel)
- **@directus/system-data**
- Updated esbuild to 0.25 ([#24794](https://github.com/directus/directus/pull/24794) by @br41nslug)
- **@directus/types**
- Updated policy type definition ([#24791](https://github.com/directus/directus/pull/24791) by @br41nslug)
- **@directus/sdk**
- Updated utilitySort type signature allowing `string | number` ([#24753](https://github.com/directus/directus/pull/24753) by @subtirelumihail)
### 📦 Published Versions
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `[email protected]`
- `[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[email protected]`