⚠️ Breaking Change
Impact Score: 7/10
Directus v10.2.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 v10.2.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 live preview functionality to the Data Studio App to easily and instantly track the impact of item changes on web pages (#17794 by @Nitwel)
- Improve custom translations management and performance (#18097 by @br41nslug)
- Added synchronization across horizontally scaled instances to schedule flows and hooks (#18584 by @nickrum)
- Enable caching for requests from data studio when `CACHE_AUTO_PURGE` is enabled (#18484 by @licitdev)
- Added a new `FILES_MAX_UPLOAD_SIZE` environment variable for setting a max value system-wide (#18735 by @rijkvanzanten)
- Improve custom translations management and performance
⚡ Performance & Enhancements (1)
- Improved Affordance of Docs Card Component Link (#18628 by @ConnorSimply)
🔧 Bug Fixes & Patches (6)
- Updated dependencies in all packages (#18643 by @paescuj)
- Removed unnecessary disclosure of potentially sensitive server info
- Fixed `FILES_MAX_UPLOAD_SIZE` crashing bug and files interface error when the upload request errors (#18737 by @licitdev)
- Added pagination to flow logs to prevent memory allocation issues on large revision sets (#18652 by @rijkvanzanten)
- Fixed `group-accordion` value initialization for usage in extension options (#18638 by @hanneskuettner)
- Fixed input-block-editor popover styles on dark mode (#18704 by @that1matt)
📄 View Raw Release Notes (Original Developer Log)
### ⚠️ Potential Breaking Changes
- **@directus/api**
- **Removed unnecessary disclosure of potentially sensitive server info ([#18648](https://github.com/directus/directus/pull/18648) by @licitdev)**
This changes the available information and output type signature of the /server/info endpoint
- **@directus/update-check**
- Replaced update info in `@directus/api` by an update notifier in the `directus` package ([#18738](https://github.com/directus/directus/pull/18738) by @paescuj)
### ✨ New Features & Improvements
- **@directus/app**
- Added live preview functionality to the Data Studio App to easily and instantly track the impact of item changes on web pages ([#17794](https://github.com/directus/directus/pull/17794) by @Nitwel)
- Improve custom translations management and performance ([#18097](https://github.com/directus/directus/pull/18097) by @br41nslug)
- **@directus/api**
- Added synchronization across horizontally scaled instances to schedule flows and hooks ([#18584](https://github.com/directus/directus/pull/18584) by @nickrum)
- Enable caching for requests from data studio when `CACHE_AUTO_PURGE` is enabled ([#18484](https://github.com/directus/directus/pull/18484) by @licitdev)
- Added a new `FILES_MAX_UPLOAD_SIZE` environment variable for setting a max value system-wide ([#18735](https://github.com/directus/directus/pull/18735) by @rijkvanzanten)
- Improve custom translations management and performance
- Added support for `FILES_MIME_TYPE_ALLOW_LIST` environment variable. ([#18736](https://github.com/directus/directus/pull/18736) by @rijkvanzanten)
- **@directus/types**
- Improve custom translations management and performance
- Added basic types for data packages ([#18555](https://github.com/directus/directus/pull/18555) by @jaads)
- **@directus/random**
- Added randomAlpha, randomArray, randomInteger, randomSequence, and randomUUID functions ([#18668](https://github.com/directus/directus/pull/18668) by @rijkvanzanten)
### 🐛 Bug Fixes & Optimizations
- **@directus/app**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- Removed unnecessary disclosure of potentially sensitive server info
- Fixed `FILES_MAX_UPLOAD_SIZE` crashing bug and files interface error when the upload request errors ([#18737](https://github.com/directus/directus/pull/18737) by @licitdev)
- Added pagination to flow logs to prevent memory allocation issues on large revision sets ([#18652](https://github.com/directus/directus/pull/18652) by @rijkvanzanten)
- Fixed `group-accordion` value initialization for usage in extension options ([#18638](https://github.com/directus/directus/pull/18638) by @hanneskuettner)
- Fixed input-block-editor popover styles on dark mode ([#18704](https://github.com/directus/directus/pull/18704) by @that1matt)
- Fixed fetching of all permissions ([#18655](https://github.com/directus/directus/pull/18655) by @paescuj)
- Translated field names in collection dialog ([#18708](https://github.com/directus/directus/pull/18708) by @br41nslug)
- Optimised export sidebar aggregation call ([#18724](https://github.com/directus/directus/pull/18724) by @licitdev)
- Bumped @sindresorhus/slugify to fix undesirable behavior in slugify input ([#18639](https://github.com/directus/directus/pull/18639) by @hanneskuettner)
- Enhanced translations in export sidebar ([#18686](https://github.com/directus/directus/pull/18686) by @paescuj)
- Fixed incorrect endpoints for system collections ([#18657](https://github.com/directus/directus/pull/18657) by @licitdev)
- **@directus/api**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- Added live preview functionality to the Data Studio App to easily and instantly track the impact of item changes on web pages ([#17794](https://github.com/directus/directus/pull/17794) by @Nitwel)
- Updated `openapi3-ts` to v4 ([#18722](https://github.com/directus/directus/pull/18722) by @paescuj)
- Fixed `FILES_MAX_UPLOAD_SIZE` crashing bug and files interface error when the upload request errors ([#18737](https://github.com/directus/directus/pull/18737) by @licitdev)
- Optimised countDistinct aggregation on primary key field ([#18717](https://github.com/directus/directus/pull/18717) by @licitdev)
- Replaced update info in `@directus/api` by an update notifier in the `directus` package ([#18738](https://github.com/directus/directus/pull/18738) by @paescuj)
- Improved redaction of logs in Flows by catching additional keys ([#18534](https://github.com/directus/directus/pull/18534) by @paescuj)
- Updated handler response format for manual flows ([#18741](https://github.com/directus/directus/pull/18741) by @licitdev)
- Removed cdn.directus.io from imgSrc and mediaSrc in the base CSP configuration ([#18728](https://github.com/directus/directus/pull/18728) by @azrikahar)
- **@directus/composables**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **create-directus-extension**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/data-driver-postgres**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/data**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/exceptions**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/extensions-sdk**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/pressure**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/random**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/release-notes-generator**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/storage-driver-azure**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/storage-driver-cloudinary**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/storage-driver-gcs**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/storage-driver-local**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/storage-driver-s3**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/storage**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/types**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- Added live preview functionality to the Data Studio App to easily and instantly track the impact of item changes on web pages ([#17794](https://github.com/directus/directus/pull/17794) by @Nitwel)
- **@directus/update-check**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- **@directus/utils**
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- Added live preview functionality to the Data Studio App to easily and instantly track the impact of item changes on web pages ([#17794](https://github.com/directus/directus/pull/17794) by @Nitwel)
- **@directus/specs**
- Updated `openapi3-ts` to v4 ([#18722](https://github.com/directus/directus/pull/18722) by @paescuj)
### 📝 Documentation
- Added synchronization across horizontally scaled instances to schedule flows and hooks ([#18584](https://github.com/directus/directus/pull/18584) by @nickrum)
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- Removed unnecessary disclosure of potentially sensitive server info
- Added documentation for auth create and update hooks ([#18641](https://github.com/directus/directus/pull/18641) by @paescuj)
- Added live preview functionality to the Data Studio App to easily and instantly track the impact of item changes on web pages ([#17794](https://github.com/directus/directus/pull/17794) by @Nitwel)
- Improved Affordance of Docs Card Component Link ([#18628](https://github.com/directus/directus/pull/18628) by @ConnorSimply)
- Added initial docs for running tests in the codebase ([#18061](https://github.com/directus/directus/pull/18061) by @licitdev)
### 🧪 Blackbox Tests
- Updated dependencies in all packages ([#18643](https://github.com/directus/directus/pull/18643) by @paescuj)
- Enable caching for requests from data studio when `CACHE_AUTO_PURGE` is enabled ([#18484](https://github.com/directus/directus/pull/18484) by @licitdev)
### 📦 Published Versions
- `@directus/[email protected]`
- `@directus/[email protected]`
- `@directus/[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]`