How to upgrade TinyMCE version

The manual explains how to make TinyMCE 5 to TinyMCE 6 migration easy
NOTE: Prior to upgrading, please be aware that TinyMCE 5 custom plugins may not be compatible with TinyMCE 6.

The procedure for configuring a basic TinyMCE 6 instance remains the same as TinyMCE 5:

  1. Download the latest version of TinyMCE 6 under the TinyMCE Community heading.
  2. Extract the contents of the files, and then replace the existing TinyMCE folder in your project with the newly extracted TinyMCE folder.
  3. Done!

Now your website features editing of content using the new editor. If that didn't happen, see debugging steps below.

Debug TinyMCE upgrade

Step 1: Check console log

After completing the upgrade, it is crucial to double-check your developer tools' console log for any errors, particularly if you have developed custom plugins yourself or included plugins from an open-source project. This step ensures a smooth transition and helps identify and address any potential issues that may arise during or after the upgrade process.

Step 2: Check difference with new sintax

TinyMCE 6 introduces specific plugin formatting rules. You can configure plugins using one of the three following patterns:

//1 method
plugins: [ 'image', 'help', 'wordcount' ]
//2 method
plugins: 'image help wordcount'
//3 method
plugins: 'image,help,wordcount'

Step 3: Check official changelog

Some plugins are now integrated into the TinyMCE core, eliminating the need to specify them separately in the plugins, menubar, or toolbar configuration. Additionally, certain plugins that were previously available for free are now exclusively included in TinyMCE premium plans.

Be sure to explore the migration doc for comprehensive details on all the changes.