Upgrading TinyMCE

Learn more about TinyMCE 5 LTS if you need to remain on TinyMCE 5 and continue to receive security updates.

Upgrading to the latest version of TinyMCE 7

The procedure for upgrading to the latest version of TinyMCE 7 depends on the deployment type.

Upgrading Tiny Cloud

Tiny Cloud provides the latest enterprise version of TinyMCE. For information on configuring Tiny Cloud, see: the Cloud deployment guide.

Upgrading TinyMCE Self-hosted using a package manager

Select from the following package managers.

Yarn

To upgrade to TinyMCE 7.5 using Yarn, run:

yarn upgrade tinymce

npm

To upgrade to TinyMCE 7.5 using npm, run:

npm install tinymce@latest --save

Composer

To upgrade to TinyMCE 7.5 using Composer, run:

composer require tinymce/tinymce

NuGet

To upgrade to TinyMCE 7.5 using NuGet, run:

Install-Package TinyMCE

Bower

To upgrade to TinyMCE 7.5 using Bower, run:

bower install tinymce#7.5 --save

Upgrading TinyMCE Self-hosted manually

To upgrade to TinyMCE 7.5 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:

    tinymce/
    ├── icons/
    ├── langs/
    ├── models/
    ├── plugins/
    ├── skins/
    │   ├── content/
    │   └── ui/
    └── themes/
  2. Download the latest version of TinyMCE.

    • For the TinyMCE Community Version, download tinymce_<VERSION>.zip from Get TinyMCE - Self-hosted releases, where <VERSION> is the latest version of TinyMCE.

    • For the TinyMCE Enterprise Version, download the TinyMCE Enterprise Bundle from Tiny 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.

  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/.

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.

    • Set the location of custom plugins using external_plugins.

    • Set the location of custom icon packages using icons_url instead of icons.

    • Set the location of custom localization packages using language_url instead of language.

    • Set the location of custom skin packages using skin_url instead of skin.

    • Set the location of custom themes using theme_url instead of theme.