Skip to content

Document Directus 12.4.0 - #831

Merged
ChristopherJennings merged 1 commit into
mainfrom
claude/directus-v12-changelog-sync-8acc4f
Sep 22, 2026
Merged

ChristopherJennings merged 1 commit into
mainfrom
claude/directus-v12-changelog-sync-8acc4f

Conversation

@ChristopherJennings

Copy link
Copy Markdown
Contributor

Summary

Syncs the docs with the Directus 12.4.0 release and fills the changelog gap for 12.3.0 and 12.3.1.

What changed

Breaking changes (content/releases/3.breaking-changes/3.version-12.md)

New "Version 12.4.0" section covering:

  • Inactive collections reject API reads and writes with the new COLLECTION_INACTIVE error (#27792). Filed upstream as a bug fix, but it turns a Studio-only status into an API-level block.
  • Update and delete by query now enforce read permissions when resolving affected items (#28143, GHSA-2xcm-7h22-3m66).
  • Map layout and map interface require WebGL2 after the MapLibre 6 upgrade (#28216).
  • @directus/themes requires @unhead/vue 3 (#28248).
  • Corrected system type definitions in @directus/types and @directus/sdk, consolidated from #27956 and #27970.

Changelog (content/releases/2.changelog.md)

  • September 2026 entry for 12.4.0, linking to the breaking changes anchor and to the Flows pages that already document the module move, hidden manual buttons, and Send Email From Name (Flows enhancements #818).
  • August 2026 entry for 12.3.0 and 12.3.1, which was missing even though the 12.3.0 breaking changes were documented in Document 12.3.0 breaking changes #813.

Other pages

  • content/configuration/email.md: documents the Mailtrap transport. Variable names were verified against packages/env at the v12.4.0 tag; the shipped name is EMAIL_MAILTRAP_TEST_INBOX_ID, not the INBOX_ID name in the upstream PR description.
  • content/guides/01.data-model/1.collections.md: adds the Status setting and a new Inactive Collections section explaining how collections become inactive (licensing resolution flow), what is blocked, what still works, and how to reactivate.
  • content/guides/04.connect/5.errors.md: adds COLLECTION_INACTIVE (403) to the error code table.
  • content/licensing/1.overview.md: links the resolution flow to the Inactive Collections section.

Reviewer notes

  • Open PR Document Mailtrap email transport #768 documents Mailtrap with nearly identical content. This PR supersedes it, so Document Mailtrap email transport #768 can be closed when this merges.
  • DEV_APP_PORT is intentionally not documented. It only affects the monorepo's Vite dev server and the dev environment page has no port section today.
  • All six pages were loaded in a local dev server and every new anchor used in cross-links resolves (#version-1240, #version-1230, #inactive-collections, #mailtrap, #september-2026, #august-2026, #resolution-flow, #send-email, #manual).

🤖 Generated with Claude Code

Add the Version 12.4.0 section to the v12 breaking changes page covering
inactive collection enforcement, read permissions on update and delete by
query, the WebGL2 requirement for maps, the @directus/themes peer
dependency on @unhead/vue 3, and corrected system type definitions.

Add September 2026 (12.4.0) and the missing August 2026 (12.3.0) entries
to the changelog, document the Mailtrap email transport, add the
COLLECTION_INACTIVE error code, describe inactive collections in the
collections guide, note the WebGL2 requirement on the map layout and
interface, and link the licensing resolution flow to inactive collections.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@ChristopherJennings
ChristopherJennings requested a review from a team as a code owner September 22, 2026 23:45
@vercel

vercel Bot commented Sep 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Sep 22, 2026 11:50pm UTC

Request Review

@ChristopherJennings
ChristopherJennings merged commit e03a874 into main Sep 22, 2026
5 of 6 checks passed
@ChristopherJennings
ChristopherJennings deleted the claude/directus-v12-changelog-sync-8acc4f branch September 22, 2026 23:48

This branch was successfully deployed

1 active deployment
Preview 2a189ef7 Deployed Sep 22, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant