From ef2df5e2b87564aabdb9a40cd0923c9955260cde Mon Sep 17 00:00:00 2001 From: alvarosabu Date: Sat, 10 Oct 2026 09:54:55 +0200 Subject: [PATCH 1/2] Enhance rich text extension documentation with reload guidance --- .../09.extensions/3.app-extensions/7.richtext.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/content/guides/09.extensions/3.app-extensions/7.richtext.md b/content/guides/09.extensions/3.app-extensions/7.richtext.md index df36617b..98d17df2 100644 --- a/content/guides/09.extensions/3.app-extensions/7.richtext.md +++ b/content/guides/09.extensions/3.app-extensions/7.richtext.md @@ -69,6 +69,16 @@ When a Directus major version upgrades Tiptap, update your extension before your 4. Set `host` to the new major version, for example `^13.0.0`. 5. Publish the update as a new major version of your extension. +## Reload During Development + +The editor builds its schema from the registered extensions when it opens. Tiptap does not let an open editor change its schema, so an open editor does not pick up a reloaded extension. + +When Directus reloads extensions, for example with `EXTENSIONS_AUTO_RELOAD` or from the extensions settings page, editors that are already open keep the previous version of your extension. To use the new version, save your changes and reload the page in your browser. + +::callout{icon="i-lucide-info"} +If a rich text field has unsaved changes, the browser asks you to confirm before it reloads the page. +:: + ## Next Steps Read about [publishing to the Marketplace](/guides/extensions/marketplace/publishing), the [WYSIWYG interface options](/guides/data-model/interfaces#wysiwyg), and [custom formats](/guides/data-model/rich-text) for the editor. From 12b727f54da88934e062c335fb3a2f0cb6cd7079 Mon Sep 17 00:00:00 2001 From: alvarosabu Date: Mon, 19 Oct 2026 10:13:38 +0200 Subject: [PATCH 2/2] Name the actions that reload extensions in the richtext guide --- content/guides/09.extensions/3.app-extensions/7.richtext.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/guides/09.extensions/3.app-extensions/7.richtext.md b/content/guides/09.extensions/3.app-extensions/7.richtext.md index 98d17df2..e7f49cad 100644 --- a/content/guides/09.extensions/3.app-extensions/7.richtext.md +++ b/content/guides/09.extensions/3.app-extensions/7.richtext.md @@ -73,7 +73,7 @@ When a Directus major version upgrades Tiptap, update your extension before your The editor builds its schema from the registered extensions when it opens. Tiptap does not let an open editor change its schema, so an open editor does not pick up a reloaded extension. -When Directus reloads extensions, for example with `EXTENSIONS_AUTO_RELOAD` or from the extensions settings page, editors that are already open keep the previous version of your extension. To use the new version, save your changes and reload the page in your browser. +When Directus reloads extensions (with `EXTENSIONS_AUTO_RELOAD`, or when you enable, disable, install or uninstall an extension in Settings → Extensions), editors that are already open keep the previous version of your extension. The Data Studio shows a "Reload Required" notice. Save your changes and reload the page to use the new version. ::callout{icon="i-lucide-info"} If a rich text field has unsaved changes, the browser asks you to confirm before it reloads the page.