[ChristopherJennings]

Summary

Documents Directus 12.6.0, released 2026-10-27.

Release pages

• Breaking changes: new Version 12.6.0 section covering:
  • the Node.js 26 requirement and its effect on extensions
  • removed deprecated AI models, and recommended defaults for unset Allowed Models
  • the OpenAPI x-metadata → Metadata rename
  • the telemetry and compliance URL move to telemetry.directus.com
  • the PUBLIC_POLICY_ID removal from @directus/constants
• Changelog: October 2026 now lists three releases, with a 12.6.0 summary.

Pages updated to match 12.6.0

• AI Assistant setup: recommended default allowed models, Clear Value, and retired models in saved selections (Update built-in AI model lists and defaults directus#28344).
• Licensing overview: license warnings now also appear in the sidebar ( Show license warnings in the sidebar directus#28394).
• Logging config: RETENTION_BATCH must be a positive integer and is capped at the database's binding limit (Fix foreign key violation in retention schedule when a revision's parent is already deleted directus#28223).
• MCP troubleshooting: new entry for the 405 Method Not Allowed response (Update /mcp to return 405 Method Not Allowed for authenticated GET and HEAD requests directus#28360).
• Including Extensions and Hardened Images: Dockerfile build stages use node:26-alpine and install pnpm with npm instead of corepack enable.
• Self-hosting requirements: Node.js 26 or newer for npm installs.
• Contributor dev environment: install the pnpm version from packageManager with npm, instead of using Corepack (Update to Node v26 directus#27737).

Not included here

• AI model tables: covered by the open Update supported AI models #842.
• Telemetry URL on the configuration and telemetry pages: covered by the open Update telemetry and compliance URL defaults to telemetry.directus.com and add upgrade warning #849.
• richtext extensions, the Default Exports Folder, and the Public policy warnings were documented before the release.
• @directus/schema-builder 2.0.0 is skipped because the package isn't documented.

⚠️ Inferred, please verify

The following statements are my own inferences from code, specs, or Node.js itself. The 12.6.0 release notes and PRs don't state them directly.

1. Node.js 26 doesn't bundle Corepack. This comes from Node.js dropping Corepack from its distribution in v25, not from Update to Node v26 directus#27737. That PR only says Directus stopped using Corepack. The breaking change entry and both Dockerfile examples rely on it: corepack enable → npm install --global pnpm. Please confirm that corepack enable really fails on node:26-alpine.
2. RETENTION_BATCH cap values. The examples (999 on Oracle, 2097 on MS SQL Server) are worked out from getMaxBindings() - 1 in the retention schedule. Oracle returns 1000 and MS SQL Server returns 2098. SQLite (32765) and PostgreSQL (65534) aren't listed. MySQL has no cap.
3. MCP clients carry on over POST after a 405. The troubleshooting entry says most clients continue automatically. This is based on the MCP Streamable HTTP spec, which allows servers to answer the optional GET stream with 405. Neither the PR nor I tested it against real clients.
4. "Previously, new projects had no allowed models." This comes from a review note on Update built-in AI model lists and defaults directus#28344: the settings row was created after migrations ran, so fresh installs never got the default list. The release notes don't say it.
5. Public role policies are found with role and user both null on directus_access. This comes from the app's new useIsAttachedToPublicRole composable in Show public permission notices for any policy within the public role directus#28348. The breaking change entry gives it as the replacement for PUBLIC_POLICY_ID.

Testing

Ran pnpm dev locally and checked that every changed page renders. All new internal links and anchors resolve, including #version-1260 from the changelog.

🤖 Generated with Claude Code

[vercel]

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

Project	Deployment	Actions	Updated
docs	Ready	Preview	Oct 28, 2026 9:07pm UTC