Important changes to Tiny Cloud pricing > Find out more

NOTE: TinyMCE 5 reached End of Support in April 2023. No more bug fixes, security updates, or new features will be introduced to TinyMCE 5. We recommend you upgrade to TinyMCE 6 or consider TinyMCE 5 Long Term Support (LTS) if you need more time.

Specify editor & plugin versions

Specifying editor and plugin versions for Tiny Cloud deployments.

Contribute to this page

Specifying the TinyMCE editor version deployed from Cloud

Use the URL provided to specify the TinyMCE version when deploying via Tiny Cloud. Refer to the TinyMCE editor via the Tiny Cloud for more information.

The following example is the default for loading TinyMCE 5 via Tiny Cloud. Substitute ‘no-api-key’ with your api key in the examples below.

<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/tinymce.min.js" referrerpolicy="origin"></script>

This URL specifies the latest and quality assured release of TinyMCE.

Selecting specific version numbers

All Tiny Cloud channels are based on the TinyMCE Enterprise version. For information on the latest version of the Tiny Cloud 5 release channel, see: TinyMCE Release Notes. For a list of changes that may be present in the Tiny Cloud testing channel, see: TinyMCE Changelog.

5, 5-testing, and 5-dev release channels

Choose from the 5, 5-testing, or 5-dev release channels to load the latest version of TinyMCE from Tiny Cloud.

These channels are updated automatically and provide the latest TinyMCE version that matches the criteria below.

5 release channel

This channel deploys the latest release of TinyMCE that has passed our quality assurance process. The current version of TinyMCE available through the /5 channel can be found on the Tiny Cloud TinyMCE 5 version page. The TinyMCE 5 channel can be loaded from https://cdn.tiny.cloud/1/no-api-key/tinymce/5/tinymce.min.js.

Example: Using the 5 release channel
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/tinymce.min.js" referrerpolicy="origin"></script>

5-testing release channel

This channel deploys the current release candidate for the 5 channel. The TinyMCE release candidate is undergoing quality assurance. The current version of TinyMCE available through the 5-testing channel can be found on the Tiny Cloud TinyMCE 5-testing version page.

Example: Using the 5-testing release channel
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5-testing/tinymce.min.js" referrerpolicy="origin"></script>

5-dev release channel

This channel deploys nightly builds of TinyMCE. This channel includes the unreleased changes documented in the TinyMCE changelog. The current version of TinyMCE available through the 5-dev channel can be found on the Tiny Cloud TinyMCE 5-dev version page.

Example: Using the 5-dev release channel
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5-dev/tinymce.min.js" referrerpolicy="origin"></script>

Specifying the version of premium plugins deployed from Tiny Cloud

Each TinyMCE version is bundled with a set of premium plugins, but it is possible to specify different versions of each premium plugin to use with TinyMCE. Use the URL query parameters to specify the version of each premium plugin to load. This approach works with both the TinyMCE editor and premium plugins deployment via Tiny Cloud or just the premium plugins deployment from Tiny Cloud.

The identifier of the plugin is used as a query parameter. This table summarises the possible options.

Plugin Identifier Supported Versions
Accessibility Checker a11ychecker Versions
Advanced Code Editor advcode Versions
Advanced Tables advtable Versions
Case Change casechange Versions
Checklist checklist Versions
Comments comments Versions
Enhanced Media Embed mediaembed Versions
Export export Versions
Format Painter formatpainter Versions
Link Checker linkchecker Versions
Mentions mentions Versions
Page Embed pageembed Versions
Permanent Pen permanentpen Versions
PowerPaste powerpaste Versions
Spell Checker Pro tinymcespellchecker Versions
Tiny Drive tinydrive Versions

Specifying versions for the editor and premium plugin deployment

When deploying both the editor and premium plugins from Tiny Cloud, TinyMCE will load the premium plugins bundled with that version of the editor. To load a different version of a premium plugin, append the name of the plugin and the version to load as query parameters. The version must match one of the versions listed in the Supported Versions link for the relevant plugin.

Combine multiple plugin specifications using & in your query string. For example, to load:

  • mentions v2.2
  • powerpaste v5.5
  • all other premium plugins from those bundled with 5

Append ?mentions=2.2&powerpaste=5.5, such as:

<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/tinymce.min.js?mentions=2.2&powerpaste=5.5" referrerpolicy="origin"></script>

Specifying a self-hosted deployment of features/plugins

When deploying only premium plugins from Tiny Cloud, some features are served from Tiny Cloud and some features served from a self-hosted installation. There are two ways to achieve this: plugins.min.js and cloud-plugins.min.js.

plugins.min.js

Instead of loading tinymce.min.js from Tiny Cloud, serve TinyMCE from a self-hosted server, and load plugins.min.js from Tiny Cloud. TinyMCE which will attempt to load every premium plugin from Tiny Cloud, unless the version of the plugin is specified as the special version sdk. The query string for plugins.min.js works the same way as tinymce.min.js, except for the addition of sdk. For example, this script tag:

The following example:

  • Assumes TinyMCE has already been loaded by another script on the page.
  • Attempts to load mentions v2.2 and powerpaste v5.5 from Tiny Cloud.
  • Attempts to load advcode from the self-hosted installation.
  • Attempts to load all other premium plugins from those bundled with version 5 of TinyMCE.
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/plugins.min.js?mentions=2.2&powerpaste=5.5&advcode=sdk" referrerpolicy="origin"></script>

The disadvantage of plugins.min.js: to load only one plugin from the Tiny Cloud and the rest from a self-hosted deployment, ALL other plugins need to be added as query parameter with the version as sdk. When Tiny Cloud releases a new plugin, this will need to be updated. In situations where most premium plugins need to be loaded from a self-hosted deployment, use cloud-plugins.min.js.

cloud-plugins.min.js

Instead of loading tinymce.min.js from Tiny Cloud, serve TinyMCE from a self-hosted server, and load cloud-plugins.min.js from Tiny Cloud. Unlike plugins.min.js, cloud-plugins.min.js defaults to loading every premium plugin from the self-hosted TinyMCE installation, not Tiny Cloud. However, plugins can be loaded from Tiny Cloud by specifying them as query parameters.

With cloud-plugins.min.js, the plugins listed in the query strings do not require a version. If there is no version specified, TinyMCE uses the version bundled with the TinyMCE version requested. There is also no need to specify sdk as the version for any plugin, as that is the default.

The following example:

  • Assumes TinyMCE has already been loaded by another script on the page.
  • Attempts to load mentions v2.2 and powerpaste v5.5 from Tiny Cloud.
  • Attempts to load advcode from the version bundled with version 5 of TinyMCE because it doesn’t specify a version.
  • Attempts to load all other premium plugins from the self-hosted installation.
<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/cloud-plugins.min.js?mentions=2.2&powerpaste=5.5&advcode" referrerpolicy="origin"></script>

The disadvantage of cloud-plugins.min.js: every plugin to be loaded from Tiny Cloud must be added to the query parameter. When Tiny Cloud releases a new plugin, this will need to be updated. In situations where most premium plugins need to be loaded from Tiny Cloud, use plugins.min.js.

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.