Upgrading TinyMCE

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.
• Upgrading TinyMCE Self-hosted using a package manager.
• Upgrading TinyMCE Self-hosted manually.

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
• npm
• Composer
• NuGet
• Bower

Yarn

To upgrade to TinyMCE 5.10 using Yarn, run:

$ yarn upgrade tinymce

npm

To upgrade to TinyMCE 5.10 using npm, run:

$ npm install tinymce@latest --save

Composer

To upgrade to TinyMCE 5.10 using Composer, run:

$ composer require tinymce/tinymce

NuGet

To upgrade to TinyMCE 5.10 using NuGet, run:

$ Install-Package TinyMCE

Bower

To upgrade to TinyMCE 5.10 using Bower, run:

$ bower install tinymce#5.10 --save

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:

    tinymce/
    ├── icons/
    ├── langs/
    ├── 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/.

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

Can't find what you're looking for? Let us know.

Except as otherwise noted, the content of this page is licensed under the Creative Commons BY-NC-SA 3.0 License, and code samples are licensed under the Apache 2.0 License.