TinyMCE 8.3.0

These are the Tiny Cloud and TinyMCE Enterprise release notes. For information on the latest community version of TinyMCE, see the TinyMCE Changelog.

Overview

TinyMCE 8.3.0 was released for TinyMCE Enterprise and Tiny Cloud on Wednesday, December 10th, 2025. These release notes provide an overview of the changes for TinyMCE 8.3.0, including:

Premium plugins now available via NPM

TinyMCE 8.3.0 introduces the tinymce-premium NPM package, providing commercial customers with easy access to all premium plugins, skins, icons, and language packs directly from the NPM registry. The package is available for download at https://www.npmjs.com/package/tinymce-premium.

The tinymce-premium package simplifies the installation and integration of premium plugins. To get started with using premium plugins with TinyMCE, see: Quick start: TinyMCE from NPM or Yarn.

Accompanying Premium plugin changes

The following premium plugin updates were released alongside TinyMCE 8.3.0.

PowerPaste

The TinyMCE 8.3.0 release includes an accompanying release of the PowerPaste premium plugin.

PowerPaste includes the following addition.

powerpaste_emf_processor function that takes an emf blob and returns a promise of a png blob.

Before October 2025, copying and pasting content from Microsoft Word containing emf images resulted in those images not being pasted and an error message being displayed. After October 2025, this behavior changed where the images began appearing in the editor, but only at low resolution, accompanied by an error message in Chrome and Firefox. Safari displayed the low-resolution images without showing an error message.

This change negatively affected the user experience. After October 2025, users would see a low-quality image alongside an error message stating Some images failed to import, which caused confusion since the image was, in fact, visible in the editor—albeit with degraded quality.

TinyMCE 8.3.0 introduces a new option, powerpaste_emf_processor, to address this issue. This option accepts a function that receives an emf blob and returns a promise resolving to a png blob (i.e. (blob: Blob) ⇒ Promise<Blob>).

  • If this option is provided, the editor will invoke the supplied function to convert emf image blobs into png image blobs before inserting them into the editor.

  • If this option is not provided, the editor will remove the low-quality images and display an error message, restoring the pre–October 2025 behavior.

If only the image is selected, pasting it will succeed and the image will be inserted correctly. However, if the image is selected together with other types of content, such as text, the image will not be pasted and an error message will be displayed.

For information on the PowerPaste plugin, see: PowerPaste.

Media Optimizer

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

Media Optimizer includes the following improvements and fixes.

Support for uploading additional file types

The Media Optimizer plugin now supports uploading many additional file types through the link dialog, including documents (PDF, Word, Excel, PowerPoint, RTF, plain text), iWork files (Keynote, Pages, Numbers), audio files (WAV, MP3, OGG), and archive files (ZIP, GZIP, TAR, 7Z, RAR). A full list of supported file types is available in the documentation.

The default list of supported file types can be customized using the documents_file_types option.

For information on the Media Optimizer plugin, see: Media Optimizer: Files and Documents.

Newly uploaded videos are now responsive

Newly uploaded videos are now responsive by default. Videos automatically scale down on smaller screens while maintaining their maximum size. For more information, see: uploadcare_video_properties configuration option.

For information on the Media Optimizer plugin, see: Media Optimizer: Video.

CSS resource files were not loaded correctly.

Previously, Media Optimizer CSS resource files were not loaded correctly. This mainly caused issues when trying to bundle this plugin. In TinyMCE 8.3.0, this issue has been resolved by ensuring that CSS resource files for Media Optimizer are now loaded correctly.

For information on the Media Optimizer plugin, see: Media Optimizer.

Premium plugins now include ESM module support

Premium plugins in TinyMCE 8.3.0 can now be consumed as native ES modules (import) in addition to CommonJS (require). This enhancement aligns premium plugins with the existing ESM capabilities already available in core plugins and applies to all distributed artifacts, including NPM packages and ZIP bundles. The update enables modern bundlers to automatically resolve the optimal module format, improving compatibility with ESM-focused toolchains and removing the need for CommonJS shims during integration.

Improvements

TinyMCE 8.3.0 also includes the following improvements:

Show editor notification when a premium plugin is not allowed for a given license key.

Previously, when a premium plugin was not permitted for a given license key, the plugin would be disabled without any corresponding editor message. As of 8.3.0, this behaviour has been improved: the editor now displays a notification when a plugin is disabled due to license restrictions, reducing ambiguity.

For more informaton on license keys, see: License Key.

Accordions can now be opened and closed when the editor is set to readonly.

In previous versions of TinyMCE, accordion behavior in readonly mode relied on the browser’s default handling, which could still modify the DOM and lead to undesirable, uncontrolled changes to the editor state. This meant that even when the editor was configured as readonly, expanding or collapsing accordion sections could alter the underlying content structure in inconsistent ways.

In TinyMCE 8.3.0, the Accordion plugin now explicitly manages open and close interactions in readonly mode, ensuring that any required DOM updates for toggling panels are performed in a controlled, minimally invasive manner. This improvement provides more predictable behavior, better control over how the DOM is manipulated, and a consistent user experience when interacting with accordions in readonly editors.

Additions

TinyMCE 8.3.0 also includes the following additions:

Added new configuration options to the Link plugin to support file uploads through the link dialog:

  • files_upload_handler - Specifies a function that handles file uploads in the link dialog’s upload tab

  • documents_file_types - Specifies which file types (MIME types and extensions) are supported for file uploads

  • link_uploadtab - Controls whether the "Upload" tab is displayed in the link dialog

For more information, see files_upload_handler, documents_file_types, and link_uploadtab.

New options for dropzone dialog components

Added new configuration options to the dropzone dialog component to customize the dropzone UI and file type restrictions:

  • dropAreaLabel - Specifies the text label for the drop area where files can be dragged (default: 'Drop an image here')

  • buttonLabel - Specifies the text label for the browse button (default: 'Browse for an image')

  • allowedFileTypes - Specifies a MIME type pattern for allowed file types (default: 'image/*', e.g., 'image/*', 'application/pdf')

  • allowedFileExtensions - Specifies an array of allowed file extensions (default: images_file_types, e.g., ['.jpg', '.png', '.pdf'])

For more information, see dropzone component.

Bug fixes

TinyMCE 8.3.0 also includes the following bug fixes:

Accordions could be toggled when the editor was disabled.

Earlier versions of TinyMCE allowed accordions to remain expandable even when the editor was disabled, creating inconsistent and unexpected behavior, particularly when used with the Autoresize plugin.

This could lead to content changes when none were expected and caused interaction patterns to shift between the intended custom behavior and the browser’s default handling. In 8.3.0, this issue has been resolved by ensuring accordions are fully non-interactive when the editor is disabled, preventing unintended state changes and maintaining consistent editor behavior.

Inline formats were not applied to the marker of a list item when its content was a single block element.

Previously, when applying an inline format to a fully or partially selected list that contained content wrapped inside a single block element, the style was not applied to the list item where the selection began. This resulted in inconsistent styling between the list decorator and its content.

This issue has now been resolved in 8.3.0. The logic has been updated to ensure that the inline format is applied correctly to the list item where the selection begins.

Tooltip is now translated correctly for the dropdown chevron of the bullet and number list toolbar buttons.

Previously, an issue was identified where the tooltips for the dropdown chevrons for the Bullet list and Numbered list toolbar buttons were not translated correctly. This has been resolved in 8.3.0. The dropdown chevron of these splitbuttons now displays correctly translated tooltips on hover.

Removing a line height at times did not remove it from all selected lines.

An issue was identified where removing or modifying lineheight properties on multiple elements resulted in inconsistent updates when the elements had differing values. In these cases, only the lineheight of the first line was changed or removed, while subsequent lines were not updated.

TinyMCE 8.3.0 resolves this issue by introducing improved toggling behavior for the permissive lineheight option, ensuring that all lines are now correctly updated or removed as expected.

The font-size style on list items was not copied to new list items.

Previously, an issue was identified where the font-size style applied to list items was not retained when creating new items in either numbered or bulleted lists. As a result, list items added by pressing Enter did not inherit the correct font size from the preceding item.

TinyMCE 8.3.0 addresses this issue by changing the behavior such that the font-size style is now consistently transferred to newly created list items. This ensures that all new list items have the correct font size.