--- title: "TinyMCE 5.6" description: "Release notes for TinyMCE 5.6" canonical_url: "https://www.tiny.cloud/docs/tinymce/5/release-notes56/" md_url: "https://www.tiny.cloud/docs/tinymce/5/release-notes56/index.md" version: "5" last_updated: "2024-04-09T10:06:54Z" tokens: 3269 --- Important This page documents TinyMCE 5. For new projects, Tiny recommends using the latest, most up-to-date version. [See TinyMCE 8 documentation](../../latest/). # TinyMCE 5.6 ## Overview TinyMCE 5.6 was released for TinyMCE Enterprise and Tiny Cloud on Tuesday, December 8 th, 2020. It includes TinyMCE 5.6.1 and additional changes to premium plugins. These release notes provide an overview of the changes for TinyMCE 5.6, including: - [New features](#newfeatures) - [Enhancements](#enhancements) - [Accompanying Premium Plugin changes](#accompanying-premium-plugin-changes) - [General bug fixes](#general-bug-fixes) - [Security fixes](#security-fixes) - [Upgrading to the latest version of TinyMCE 5](#upgrading-to-the-latest-version-of-tinymce-5) > **Note:** This is the Tiny Cloud and TinyMCE Enterprise release notes. For information on the latest community version of TinyMCE, see: [TinyMCE Changelog](../changelog/). ## New features The following new features were added for the TinyMCE 5.6 release. ### New `images_file_types` option for customizing recognized image file extensions The new `images_file_types` option allows different image file extensions to be recognized by: - Smart Paste’s image URL to embedded image functionality. - Allowed file extensions for the Image plugin. For information on the `images_file_types` option, see: [Image & file options - images_file_types](../file-image-upload/#images_file_types). ### New image emoji database for the Emoticons plugin A new `emojiimages` database has been added to the Emoticons plugin. This database uses images provided by the Twitter Emoji (twemoji) project to render emojis in the content. > **Important:** The `emojiimages` database provided by Tiny Technologies, Inc. uses Twitter Emoji (Twemoji) graphics under the CC-BY 4.0 license agreement. A new `emoticons_database` option has been added to specify which built-in emoji database to use in the editor. Additionally, a new `emoticons_images_url` option has been added to configure the base URL for images used in the `emojiimages` database. For information on: - The `emojiimages` database and `emoticons_database` option, see: [Emoticons plugin - `emoticons_database`](../emoticons/#emoticons_database). - The `emoticons_images_url` option, see: [Emoticons plugin - `emoticons_images_url`](../emoticons/#emoticons_images_url). ### New `format_empty_lines` option for content formatting A new `format_empty_lines` option allows empty lines to be formatted for multi-line selections when applying an "inline" format such as bold (``). For information on the `format_empty_lines` option, see: [Content Formatting - `format_empty_lines`](../content-formatting/#format_empty_lines). ### New editor events TinyMCE 5.6 introduces several new events that integrators can use for custom functionality: - A new `TableModified` event which is fired when a style or structural change is made to a table. - Two new core events which are fired before and after displaying notifications. For information on: - The `TableModified` event, see: [Table plugin - `events`](../table/#events). - Core editor events, see: [Editor core events](../events/#editorcoreevents). ### New card menu item for the autocompleter A new card menu item has been added to the autocompleter, allowing for greater customization of the autocompleter results displayed to the user. For information on customizing autocompleter results with `CardMenuItem`, see: [UI components - Autocompleter - `CardMenuItem`](../autocompleter/#cardmenuitem). ### Additional new features TinyMCE 5.6 introduces the following minor new features: - Added new user interface `enable`, `disable`, and `isDisabled` methods. - Added new `closest` formatter API to get the closest matching selection format from a set of formats. ## Enhancements The following enhancements were made for the TinyMCE 5.6 release. ### Clicking a link in `readonly` mode now opens the URL Clicking links when the editor is in `readonly` mode will open the URL in a new tab or window (depending on browser preferences). ### New optional `name` field for the `style_formats` option A new optional `name` field that sets a specific name to the format when it’s being registered using the `style_formats` option. For information on the `name` field, see: [User interface - `style_formats`](../editor-appearance/#style_formats). ## Accompanying Premium Plugin changes The following premium plugin updates were released alongside TinyMCE 5.6. ### Accessibility Checker 2.3.1 The TinyMCE 5.6 release includes an accompanying release of the **Accessibility Checker** premium plugin. **Accessibility Checker** 2.3.1 fixes an issue where internal TinyMCE elements were not ignored. For information on the Accessibility Checker plugin, see: [Accessibility Checker plugin](../a11ychecker/). ### Advanced Code Editor 2.3.0 The TinyMCE 5.6 release includes an accompanying release of the **Advanced Code Editor** premium plugin. **Advanced Code Editor** 2.3.0 adds the following new feature: - Added the ability to maintain the cursor position when opening the code dialog. **Advanced Code Editor** 2.3.0 also provides the following bug fixes: - Fixed the code view not using monospace fonts. - Fixed an issue where non-breaking spaces were inserted instead of regular spaces on Safari. For information on the Advanced Code Editor plugin, see: [Advanced Code Editor plugin](../advcode/). ### Comments 2.3.0 The TinyMCE 5.6 release includes an accompanying release of the **Comments** premium plugin. **Comments** 2.3.0 provides the following enhancement: - Introduces the `onError` and `onSuccess` callbacks for the `tinycomments_create` "done" function. **Comments** 2.3.0 also provides the following bug fixes: - Fixed nested and overlapping comments breaking the content. - Fixed long comments getting cut off. - Fixed a scrollbar appearing in the textarea when writing a comment. For information on the Comments plugin, see: [Comments plugin](../comments/). ### Mentions 2.2.0 The TinyMCE 5.6 release includes an accompanying release of the **Mentions** premium plugin. **Mentions** 2.2.0 provides the following new features: - Added a new `mentions_item_type` option for specifying which mentions user interface item to use when displaying the list of users. - Added a new `mentions_min_chars` option for specifying the number of characters required after the “@” symbol before the list of users will be displayed in the editor. - Added a new `profile` hover card for usage with the `mentions_select` option. **Mentions** 2.2.0 also provides the following bug fix: - Fixed mentions not converted to `contenteditable=false` elements when set using `editor.setContent()` For information on the Mentions plugin, see: [Mentions plugin](../mentions/). ### PowerPaste 5.4.0 The TinyMCE 5.6 release includes an accompanying release of the **PowerPaste** premium plugin. **PowerPaste** 5.4.0 provides the following enhancement: - Added a new `images_file_types` option to determine which image file types will automatically be converted into `img` tags by the `smart_paste` feature. **PowerPaste** 5.4.0 also provides the following bug fixes: - Fixed the `Cut` menu item not working in the latest version of Firefox. - Fixed two Cross-Site Scripting (XSS) vulnerability issues. For more information, see: [Security fixes](#security-fixes). For information on the PowerPaste plugin, see: [PowerPaste plugin](../introduction-to-powerpaste/). ### Spell Checker Pro 2.2.0 The TinyMCE 5.6 release includes an accompanying release of the **Spell Checker Pro** premium plugin. **Spell Checker Pro** 2.2.0 provides the following enhancements: - The spellchecker dialog now opens faster when checking large documents. - The spellchecker dialog can now be moved around and does not block access to editor content. **Spell Checker Pro** 2.2.0 also provides the following bug fixes: - Fixed the "Ignore All" action throwing an exception on words containing certain characters. - Fixed the spellchecker dialog not checking incorrect words outside of the window viewport. - Fixed the spellchecker as-you-type functionality interfering with the dialog. For information on the Spell Checker Pro plugin, see: [Spell Checker Pro plugin](../introduction-to-tiny-spellchecker/). ## General bug fixes TinyMCE 5.6 provides fixes for the following bugs: - Fixed the `block` and `unblock` dialog APIs not working for inline dialogs. - Fixed the `change` event not firing after a successful image upload. - Fixed the type signature for the `entity_encoding` setting not accepting delimited lists. - Fixed layout issues when empty `tr` elements were incorrectly removed from tables. - Fixed image file extensions lost when uploading an image with an alternative extension, such as `.jfif`. - Fixed `DOMUtils.getParents` incorrectly including the shadow root in the array of elements returned. - Fixed an issue where the root document could be scrolled while an editor dialog was open inside a shadow root. - Fixed `getContent` with text format returning a new line when the editor is empty. - Fixed table column and row resizers not respecting the `data-mce-resize` attribute. - Fixed inserting a table via the `mceInsertTable` command incorrectly creating 2 undo levels. - Fixed nested tables with `colgroup` elements incorrectly always resizing the inner table. - Fixed the `visualchars` plugin causing the editor to steal focus when initialized. - Fixed `fullpage` plugin altering text content in `editor.getContent()`. - Fixed `fullscreen` plugin not working correctly with multiple editors and shadow DOM. - Fixed font size keywords such as `medium` not displaying correctly in font size menus. - Fixed an issue where some attributes in table cells were not copied over to new rows or columns. - Fixed incorrectly removing formatting on adjacent spaces when removing formatting on a ranged selection. - Fixed the `Cut` menu item not working in the latest version of Mozilla Firefox. - Fixed some incorrect types in the new TypeScript declaration file. - Fixed a regression where a fake offscreen selection element was incorrectly created for the editor root node. - Fixed an issue where menus would incorrectly collapse in small containers. - Fixed an issue where only one table column at a time could be converted to a header. - Fixed some minor memory leaks that prevented garbage collection for editor instances. - Fixed resizing a `responsive` table not working when using the column resize handles. - Fixed incorrectly calculating table `col` widths when resizing responsive tables. - Fixed an issue where spaces were not preserved in pre-blocks when getting text content. - Fixed a regression that caused the selection to be difficult to see in tables with backgrounds. - Fixed content pasted multiple times in the editor when using Microsoft Internet Explorer 11. Patch contributed by mattford. - Fixed the `mceTableRowType` and `mceTableCellType` commands were not firing the `newCell` event. - Fixed the HTML5 `s` element was not recognized when editing or clearing text formatting. ## Security fixes TinyMCE 5.6 provides fixes for the following security issues: - Fixed a security issue where URLs in attributes weren’t correctly sanitized. - Fixed a security issue in the `codesample` plugin by upgrading dependencies. PowerPaste 5.4.0 provides fixes for the following security issues: - Fixed a Cross-Site Scripting (XSS) vulnerability where internal HTML content wasn’t sanitized in some cases. - Fixed a Cross-Site Scripting (XSS) vulnerability where specific HTML comments weren’t sanitized in some cases. ## Upgrading to the latest version of TinyMCE 5 The procedure for upgrading to the latest version of TinyMCE 5 depends on the deployment type. - [Upgrading Tiny Cloud](#upgradingtinycloud). - [Upgrading TinyMCE Self-hosted manually](#upgradingtinymceself-hostedmanually). ### Upgrading Tiny Cloud Tiny Cloud provides the latest enterprise version of TinyMCE. For information on configuring Tiny Cloud, see: [the Cloud deployment guide](../cloud-deployment-guide/). ### Upgrading TinyMCE Self-hosted manually To upgrade to TinyMCE 5.10 using a manually downloaded package: 1. Backup the `tinymce/` directory so any customizations can be restored after the upgrade. Customizations for TinyMCE are typically stored in the following directories: ```sh tinymce/ ├── icons/ ├── langs/ ├── plugins/ ├── skins/ │ ├── content/ │ └── ui/ └── themes/ ``` 2. Download the latest version of TinyMCE. - For the TinyMCE Community Version, download `tinymce_.zip` from [Get TinyMCE - Self-hosted releases](/get-tiny/self-hosted/), where `` is the latest version of TinyMCE. - For the TinyMCE Enterprise Version, download the **TinyMCE Enterprise Bundle** from [Tiny Account > Downloads](/my-account/downloads/). The downloaded file will be named `enterprise_latest.zip`. 3. Extract the downloaded `.zip` file to a temporary location. 4. (If required) Install the latest language packs from [Get TinyMCE - Language Packages](/get-tiny/language-packages/). 5. Copy customizations to the new `tinymce/` directory. Ensure that *only custom changes* are added the new `tinymce/` directory, such as: - Custom icons packs - Custom plugins - Custom skins - Custom themes 6. Delete the existing `tinymce/` directory and replace with the new `tinymce/`. > **Note:** To simplify the upgrade process to future versions of TinyMCE: > > 1. Host the TinyMCE customizations outside of the `tinymce/` directory. > 2. Update your TinyMCE configuration as required: > > - Set the location of content CSS customizations using [`content_css`](../content-appearance/#content_css). > - Set the location of custom plugins using [`external_plugins`](../integration-and-setup/#external_plugins). > - Set the location of custom icon packages using [`icons_url`](../editor-appearance/#icons_url) instead of `icons`. > - Set the location of custom localization packages using [`language_url`](../content-localization/#language_url) instead of `language`. > - Set the location of custom skin packages using [`skin_url`](../editor-appearance/#skin_url) instead of `skin`. > - Set the location of custom themes using [`theme_url`](../editor-appearance/#theme_url) instead of `theme`.