Important changes to Tiny Cloud pricing > Find out more

Upgrading TinyMCE

How to upgrade TinyMCE via TinyMCE Cloud, package manager options, Self-hosted, and custom build options.

Contribute to this page

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

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 5.1 using Yarn, run:

$ yarn upgrade tinymce

npm

To upgrade to TinyMCE 5.1 using npm, run:

$ npm install tinymce@latest --save

Composer

To upgrade to TinyMCE 5.1 using Composer, run:

$ php composer.phar update "tinymce/tinymce"

NuGet

To upgrade to TinyMCE 5.1 using NuGet, run:

$ Install-Package TinyMCE

Bower

To upgrade to TinyMCE 5.1 using Bower, run:

$ bower install tinymce#5.1 --save

Upgrading TinyMCE Self-hosted manually

To upgrade to TinyMCE 5.1 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/.

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.