Specify Editor & Plugin Versions

Specifying editor and plugin versions for Cloud deployments.

Contribute to this page

Specifying the TinyMCE editor version deployed from Cloud

When deploying the TinyMCE editor via the Cloud, you’re able to specify the editor version via the provided for URL.

Our documented default for loading TinyMCE via the Cloud is:

<script src="https://cloud.tinymce.com/stable/tinymce.min.js?apiKey=your_API_key"></script>

The “stable” in this URL specifies the latest release of TinyMCE that has successfully completed the Ephox quality assurance testing process.

This value can be customised in order to load the version of TinyMCE that best suits your needs.

This value can be replaced with any of the following supported versions of TinyMCE: https://cloud.tinymce.com/versions/tiny.

Selecting specific version numbers

You can specify a Major version number, a Major.Minor version number or a Major.Minor.Patch version number. If the Minor or Patch versions numbers are not present, it will default to the latest Minor and Patch version released.

Example

Major version number (e.g. "4").

The following would load TinyMCE 4.latest.latest:

<script src="https://cloud.tinymce.com/4/tinymce.min.js?apiKey=your_API_key"></script>
Example

Major.Minor version number (e.g. "4.3").

The following would load TinyMCE 4.3.latest:

<script src="https://cloud.tinymce.com/4.3/tinymce.min.js?apiKey=your_API_key"></script>
Example

Major.Minor.Patch version number (e.g. "4.3.2").

The following would load TinyMCE 4.3.2:

<script src="https://cloud.tinymce.com/4.3.2/tinymce.min.js?apiKey=your_API_key"></script>

If you enter a version that doesn’t exist, you will get a HTTP 404 response.

"dev", "testing" and "stable" releases

Rather than specifying a specific TinyMCE version to load from the Cloud, you can choose to select from our "dev", "testing" and "stable" release streams.

Updates to these streams will be automatic, providing you and your users with the latest TinyMCE version matching the criteria below.

"dev" release stream

This stream will deploy the absolute latest released TinyMCE version seen in the TinyMCE changelog.

The current version of TinyMCE available through the dev stream can be found at https://cloud.tinymce.com/dev/version.txt.

Example
<script src="https://cloud.tinymce.com/dev/tinymce.min.js?apiKey=your_API_key"></script>

"testing" release stream

This stream will deploy the current candidate for release to the "stable" stream. This TinyMCE build will be the next victim of the Ephox quality assurance testing process.

The current version of TinyMCE available through the testing stream can be found at https://cloud.tinymce.com/testing/version.txt.

Example
<script src="https://cloud.tinymce.com/testing/tinymce.min.js?apiKey=your_API_key"></script>

"stable" release stream

This stream will deploy the latest release of TinyMCE that has passed the Ephox quality assurance process.

The current version of TinyMCE available through the stable stream can be found at https://cloud.tinymce.com/stable/version.txt.

Example
<script src="https://cloud.tinymce.com/stable/tinymce.min.js?apiKey=your_API_key"></script>

Specifying the version of features/plugins deployed from the Cloud

Whether you’re deploying both the TinyMCE editor and premium plugins via the Cloud or deploying only premium plugins from the Cloud, you can use URL query parameters to specify the version of each premium plugin.

PowerPaste

Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&powerpaste=2.1.8"></script>

Spell Checker Pro

Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&tinymcespellchecker=0.9.6"></script>

Accessibility Checker

Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&a11ychecker=1.0.2"></script>

Advanced Code Editor

Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&advcode=1.0.2"></script>

Enhanced Media Embed

Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&mediaembed=0.0.1"></script>

Link Checker

Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&linkchecker=1.0.0"></script>

Specifying a Self-hosted deployment of features/plugins

If you're deploying only premium plugins from the Cloud, you may want to have some features served from the Cloud and some features served from your own Self-hosted installation. This is also possible with URL query parameters and the special version name "sdk".

The "sdk" version lets the TinyMCE Plugin Manager know that you're not using the Cloud version of a particular plugin and that it shouldn't serve the plugin from the Cloud. It also won't display any warning or error messages if you're not entitled to it.

PowerPaste

Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&powerpaste=sdk"></script>

Spell Checker Pro

Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&tinymcespellchecker=sdk"></script>

Accessibility Checker

Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&a11ychecker=sdk"></script>

Advanced Code Editor

Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&advcode=sdk"></script>

Enhanced Media Embed

Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&mediaembed=sdk"></script>

Link Checker

Example
<script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&linkchecker=sdk"></script>

Examples

Featuring declared editor and plugin versions

The following example would load:

<html>
   <head>
      <script src="https://cloud.tinymce.com/4.5.0/tinymce.min.js?apiKey=your_API_key&powerpaste=2.1.8&advcode=1.0.2"></script>
   </head>
   <body>
      <textarea><p>test textarea</p></textarea>
      <script>
         tinymce.init({
            selector: 'textarea',
            height: 500,
            theme: 'modern',
            plugins: [
               'advlist autolink lists link image charmap print preview hr anchor pagebreak',
               'tinymcespellchecker']
         });
      </script>
   </body>
<html>

Featuring a combination of Self-hosted and Cloud features

The following example would load:

<html>
   <head>
      <script src="https://cloud.tinymce.com/stable/plugins.min.js?apiKey=your_API_key&powerpaste=2.1.8&advcode=sdk"></script>
   </head>
   <body>
      <textarea><p>test textarea</p></textarea>
      <script>
         tinymce.init({
            selector: 'textarea',
            height: 500,
            theme: 'modern',
            plugins: [
               'advlist autolink lists link image charmap print preview hr anchor pagebreak',
               'tinymcespellchecker']
         });
      </script>
   </body>
<html>

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.