TinyMCE 8.4.0

The new Premium plugin, <Premium plugin name> // description here.

For information on the <Premium plugin name> plugin, see xref:<plugincode>.adoc[<Premium plugin name>].

The new open source plugin, <Open source plugin name> // description here.

For information on the <Open source plugin name> plugin, see xref:<plugincode>.adoc[<Open source plugin name>].

The TinyMCE 8.4.0 release includes an accompanying release of the Comments premium plugin.

Comments includes the following fixes.

The TinyMCE 8.4.0 release includes an accompanying release of the Export to PDF premium plugin.

Export to PDF includes the following addition.

The TinyMCE 8.4.0 release includes an accompanying release of the Media Optimizer premium plugin.

Media Optimizer includes the following addition and fix.

The TinyMCE 8.4.0 release includes an accompanying release of the Full Page HTML premium plugin.

Full Page HTML includes the following update.

The TinyMCE 8.4.0 release includes an accompanying release of the Suggested Edits premium plugin.

Suggested Edits includes the following improvement and fix.

TinyMCE’s xref:<plugincode>.adoc[<Premium plugin name eol>] plugin will be deactivated on <month> <DD>, <YYYY>, and is no longer available for purchase.

TinyMCE’s xref:<plugincode>.adoc[<Open source plugin name eol>] plugin will be deactivated on <month> <DD>, <YYYY>, and is no longer available for purchase.

The Enhanced Skins & Icon Packs release includes the following updates:

The Enhanced Skins & Icon Packs were rebuilt to pull in the changes also incorporated into the default TinyMCE 8.4.0 skin, Oxide.

For information on using Enhanced Skins & Icon Packs, see: Enhanced Skins & Icon Packs.

In TinyMCE 8.4.0, the dropzone in the link and image dialog upload tabs previously provided no feedback when users inserted only files with disallowed extensions. This left users unsure whether the upload had failed or the dialog had not responded. The dropzone now displays an error message when all selected files have disallowed extensions, informing users that the selected files do not have allowed extensions and prompting them to choose different files.

Previously, the directionality buttons would not apply the directionality attribute or style when toggling to the default directionality. This could cause non-default directional content to appear in the opposite direction.

In TinyMCE 8.4.0, each directionality button always applies or removes the directionality attribute on the selected block, and only appears active when directionality is explicitly set on the block.

Previously, integrators had no way to set default header rows and columns when creating tables through the editor UI. This affected the accessibility of tables and required manual intervention for integrators aiming to meet accessibility standards. The new table_default_header_rows and table_default_header_cols options enable integrators to set the number of default header rows and columns for new tables created through the editor’s UI, providing a supported way to meet accessibility requirements.

In TinyMCE 8.4.0, the dropzone dialog component supports a new onInvalidFiles callback (exposed as errorHandler in the changelog) that runs when all dropped or selected files have disallowed extensions. This enables custom error handling for invalid file uploads in dialogs that use dropzones, such as the link and image dialogs.

Previously, the noneditable plugin was converted to a feature in core in TinyMCE 6. The feature was always enabled with no documented way to turn it off, which was not always desirable for integrators.

In TinyMCE 8.4.0, a new allow_noneditable option is available. It is enabled by default. When set to false, the noneditable feature is disabled, equivalent to disabling the plugin prior to TinyMCE 6.

In TinyMCE 8.4.0, the new view_show option allows specifying which view to display when the editor is initialized. The option behaves similarly to sidebar_show but takes precedence for views; both sidebars and views can be configured to show on init.

Previously, when border-color used multiple rgb values (for example, for different sides of an element), the style compressor would incorrectly compress them into a single border shorthand. The border shorthand only supports one color, so this produced invalid CSS. This could affect tables and other elements with multi-colored borders.

In TinyMCE 8.4.0, a check was added to prevent compression when border-color contains multiple rgb values. The styles are no longer compressed into invalid shorthand.

Previously, when a dialog was blocked (for example, while loading) and then unblocked, the loading spinner disappeared without automatically focusing any other element. As a result, focus escaped the editor entirely. When using an inline editor, this caused the dialog and the rest of the editor UI to disappear.

In TinyMCE 8.4.0, unblocking a dialog now focuses the first focusable element automatically, the same as when opening a dialog. This prevents the dialog and the rest of the editor UI from disappearing when using an inline editor.

Previously, when applying formatting such as background, bold, italic, underline, or strikethrough to a multilevel list and then adding new items before the second-level list, the new items could lose some of that formatting. This occurred because creating a new line in a list item that contained a nested list sometimes trimmed the empty elements that held the applied styles.

In TinyMCE 8.4.0, the trim logic has been updated to avoid removing these elements when inserting a new line inside a list item that contains both an empty element (the styles) and a nested list. The formatting is now preserved as expected when adding new items to multilevel lists.

Previously, when uploading an empty file through the link dialog’s upload tab, the conversion to BlobInfo failed and returned a generic, cryptic error about blob and base64 encoding. As a result, users could not understand what caused the failure or how to resolve it.

In TinyMCE 8.4.0, empty file uploads are now handled by the link dialog itself, which displays a clear, user-friendly error message when an empty file is selected. Users receive a specific error that explains the issue instead of a generic conversion error.

Previously, repeatedly toggling list formatting (for example, switching between bullet and ordered lists) could cause the selection to extend unexpectedly, including content that was not initially selected. The selection would jump to adjacent lines and expand with each subsequent toggle, making it difficult to apply list changes only to the intended items.

In TinyMCE 8.4.0, the selection logic no longer considers the forced root block when the selection is not collapsed. This prevents the selection from expanding beyond the intended list items, so list formatting can be toggled without unintended selection changes.

Previously, when table_style_by_css was set to false, updating the width of a table through the Table Properties dialog did not apply the width attribute. The dialog only applied width when using CSS styles, which broke the functionality for users who rely on HTML attributes for table sizing.

In TinyMCE 8.4.0, updating the width through the Table Properties dialog now ensures the width attribute is applied correctly when table_style_by_css is false. The table dialog behaves as expected for both attribute-based and style-based width settings.

Previously, tables that used unitless width or height attributes (for example, numeric values without px or %) could not be resized correctly. Resizing handles and column operations did not behave as expected for these tables.

In TinyMCE 8.4.0, the table resize logic correctly handles unitless width and height attributes. Tables can now be resized and modified as expected regardless of how their dimensions are specified.

Previously, toolbars were incorrectly given the role group instead of toolbar, and toolbar groups were incorrectly given the role toolbar instead of group. This resulted in misleading semantics for screen readers, as users heard multiple "toolbars" without clear grouping structure and no accessible names.

In TinyMCE 8.4.0, the ARIA roles have been corrected so that toolbars use role="toolbar" and toolbar groups use role="group". This improves accessibility and screen reader behavior.

Previously, dropdown menus with matchWidth: true could sit to the left of the input when the field value overflowed past the right edge of the viewport, such as when pasting a long URL into the image dialog source field. Misalignment ranged from a slight offset to the menu sitting flush against the left edge of the viewport. The dropdown width was constrained to match the input, but the menu was not repositioned after that constraint, so the list no longer lined up with the field and looked disconnected.

In TinyMCE 8.4.0, the positioning logic now triggers a repositioning whenever the dropdown width is constrained. The dropdown remains aligned with the input as expected.

In previous version of TinyMCE, attempting to remove a link positioned after a `contentEditable="false" (CEF) element could fail because the action flow created a bookmark that normalized the selection and shifted it into the CEF; once the cursor was inside a CEF, the selection check prevented the link-removal action (and other selection-based actions) from running.

TinyMCE 8.4.0 addresses this by capturing the selection’s target before creating the bookmark, reversing the previous order so the selection is copied prior to normalization, ensuring the selection target remains valid and link removal works as expected.

In TinyMCE 8.4.0, an issue was identified where certain deletion keyboard events within lists could not be prevented due to the key handler being registered before the editor setup phase and without verifying whether the event had already been prevented. As a result, attempts to intercept and prevent selection deletion were ineffective, limiting customization and control over list behavior.

TinyMCE 8.4.0 addresses this by updating the key handler registration to occur during the init phase, and additional checks now ensure that previously prevented events are respected.

Previously, right-to-left (RTL) directionality was not correctly set for Hebrew in the language pack. This caused the editor to render the wrong directionality when Hebrew was set as the language.

In TinyMCE 8.4.0, this issue has been addressed by ensuring that the directionality is correctly set for Hebrew in the language pack.

Previously, when the editor content CSS was bundled, it was not loaded into preview iframes. This caused a visual mismatch between the editor content area and what users saw in the Preview dialog, Suggested Edits view and Revision History view.

In TinyMCE 8.4.0, the fix checks if the content CSS is available as a bundled resource and applies it to the Preview Iframe through style tags. Bundled content CSS is now correctly loaded in the Preview Iframe.