From 1cb44f133030493c890dac362af226785374de00 Mon Sep 17 00:00:00 2001 From: Alex Gaillard Date: Thu, 16 Jul 2026 11:51:06 -0400 Subject: [PATCH 1/3] docs(releases): announce WYSIWYG Tiptap migration for v12 Add a Version 12 breaking-change notice covering the TinyMCE to Tiptap engine swap (first-edit HTML normalization and the tinymceOverrides deprecation) and a matching changelog entry. Co-Authored-By: Claude Opus 4.8 (1M context) --- content/releases/2.changelog.md | 7 +++++ .../3.breaking-changes/3.version-12.md | 30 +++++++++++++++++++ 2 files changed, 37 insertions(+) diff --git a/content/releases/2.changelog.md b/content/releases/2.changelog.md index 8a9c6746..4ed1dcff 100644 --- a/content/releases/2.changelog.md +++ b/content/releases/2.changelog.md @@ -10,6 +10,13 @@ Each month, some of the Directus team talk through what’s new including core r [Watch The Changelog on Directus TV.](https://directus.com/tv/the-changelog) +## July 2026 + + + +- Directus 12.2.0 has a potential breaking change: the WYSIWYG (rich text) interface is now built on [Tiptap](https://tiptap.dev) instead of TinyMCE. Existing fields keep working, but stored HTML is normalized to supported markup on first edit and the **Options Override** (`tinymceOverrides`) option is deprecated. See the [Version 12 breaking changes](/releases/breaking-changes/version-12#wysiwyg-editor-rebuilt-on-tiptap). +- Rebuilt the WYSIWYG editor on Tiptap, an actively maintained and license-compatible library, with a redesigned toolbar that collapses overflowing tools into a Show More menu. + ## March 2026 - [Directus 11.16.0](https://github.com/directus/directus/releases/tag/v11.16.0) has some potential breaking changes: existing `draft`-keyed versions have their display name standardized to "Draft"; `@directus/visual-editing` must be updated to v2.0.0; `requestPasswordReset` now returns `Forbidden` for external auth users. diff --git a/content/releases/3.breaking-changes/3.version-12.md b/content/releases/3.breaking-changes/3.version-12.md index 295e9877..02b949f5 100644 --- a/content/releases/3.breaking-changes/3.version-12.md +++ b/content/releases/3.breaking-changes/3.version-12.md @@ -4,6 +4,36 @@ title: Version 12 description: Breaking changes may require action on your part before upgrading. --- +## Version 12.2.0 + + + +### WYSIWYG editor rebuilt on Tiptap + +The WYSIWYG interface (`input-rich-text-html`) has replaced its TinyMCE editor with [Tiptap](https://tiptap.dev). The interface id, option keys, and HTML storage format are unchanged, so existing fields continue to work without migration. Two changes may require action. + +#### Content is normalized on first edit + +The editor's schema now defines which HTML it can represent. When you open an existing value, change it, and save, markup the schema does not support is normalized or removed. This only happens when a field is edited and saved. Values you do not touch are left as they are. + +Most common HTML is preserved, including: + +- Semantic tags such as `
`, `
`, `
`/`
`, `
`/``, `
`/`
`/`
`, ``, and ``. +- `class`, `id`, `data-*`, and `aria-*` attributes on supported elements. + +The following are changed or dropped on save: + +- HTML comments. +- Inline `style` values outside the editor's supported set. +- `