TINY BLOG > Important changes to Tiny Cloud pricing > Find out more
Return to Tiny.cloud

Cloud deployment of editor & plugins

Run Tiny Cloud in less than 5 minutes.

Contribute to this page

Tiny Cloud is the easiest way to integrate TinyMCE and upgrade to premium plugins.

Tiny Cloud can be used without an API key. Refer to the Introduction & getting started guide for more information. Sign up for an API key and update the script tag to use premium plugins or avoid the in-editor developer warning.

All Tiny Cloud accounts include a free, pre-configured cloud image proxy service. This setup uses the Image tools plugin.

Integrating TinyMCE for the first time

Step 1: Insert the Tiny Cloud script tag into the webpage

Insert the TinyMCE editor code into the application to load TinyMCE for the first time. The code inserting is done by adding the following script tag into your app, or in the case of a web page the <head> of the page:

The following example adds a script tag into the application that inserts the code. Use the <head> of the page on a web page. Be sure to substitute ‘no-api-key’ with your api key.

<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/5/tinymce.min.js" referrerpolicy="origin"></script>
  Value Description
1 no-api-key Replace with your api key
2 origin= A referrerpolicy specifies how much of the current page’s URL is sent in the Referer header when the browser fetches page resources (for example, the TinyMCE editor). The use of the Referer header ensures API keys are only used on domains registered to their owners. We only care about the domain portion however (similar to the operation of Origin header), so for improved performance and privacy always set the referrerpolicy to origin when requesting Tiny resources.

Script Tag Description

Step 2: Load, customize and interact with TinyMCE

There are more than 40 open source plugins that enhance the editing experience in addition to the advanced content create solutions on Tiny Cloud. A range of simple examples are available. Refer to the Quick start section for more information.

Step 3: Specifying purchased TinyMCE plugins and toolbar/menu items

Extend the TinyMCE configuration to include any additional purchased plugins and associated toolbar and menu items. Refer to the following enablement guides for more information:

Note: spellchecker_rpc_url is not required when enabling this plugin via Tiny Cloud.

Note: Configuration of the imagetools_cors_hosts and imagetools_proxy properties occurrs automatically.

Note: It may take up to 30 minutes for the purchased plugin to be available to TinyMCE. Clear the browser’s cache.

Step 4: Forward proxy configuration

Ensure that the following URLs are accessible via this proxy if the network has a forward proxy that controls access to the internet.

  • All URLs where the editor is deployed.
  • All URLs where the plugins are deployed.
  • https://imageproxy.tinymce.com
  • https://hyperlinking.tinymce.com
  • https://spelling.tinymce.com

Ensure the tiny-api-key and tinymce-api-key headers are retained while requesting the list of above URLs.

Step 5: Specifying a translation

Download a language pack to enable a language other than English (US). Specify its location with the language_url configuration option.

Migrating from a self-hosted environment to Tiny Cloud

Step 1: Replace existing reference to tinymce.min.js

Migrating from a self-hosted environment to Tiny Cloud is easy. Remove the existing script tag that loads TinyMCE’s JavaScript.

Note: The script tag typically references tinymce.min.js hosted within the application or available at a legacy CDN.

Replace the script tag with the following:

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

Step 2: Update custom plugin paths

Reference external_plugins to ensure custom plugins or modified plugins continue to function in the Cloud deployment.

Warning! Do not use the regular plugins configuration element.

Step 3: Specify purchased TinyMCE plugins and toolbar buttons

Extend the TinyMCE configuration to include any additional purchased plugins and associated toolbar and menu items. Refer to the following enablement guides for more information:

Note: spellchecker_rpc_url is not required when enabling this plugin via Tiny Cloud.

Note: Configuration of the imagetools_cors_hosts and imagetools_proxy properties occurrs automatically.

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.