# Official Web Component integration for TinyMCE ## About Official Web Component integration for TinyMCE, the rich text editor. Web Components are a set of native browser APIs — Custom Elements, Shadow DOM, and HTML Templates — that let you build reusable, framework-agnostic HTML elements. This package wraps TinyMCE as a `` custom element, used in place of calling `tinymce.init()`. Once installed on a page, creating an editor is as simple as adding a `` tag, with many of the standard configuration properties can be specified as attributes. By default, it pulls TinyMCE from the Tiny Cloud CDN unless configured to use a different setup, such as self-hosting the [tinymce NPM package](https://www.npmjs.com/package/tinymce). ## Quickstart ### Cloud CDN 1. [Sign up for a Tiny Cloud account](https://www.tiny.cloud/pricing/) to receive a Tiny Cloud API key. 1. Then in your project: 1. Include the following script tag to load the Web Component integration from the CDN: ```html ``` 1. Add the `tinymce-editor` element with your API key and configuration as HTML attributes: ```html <p>Welcome to TinyMCE</p> ``` 1. Update the `api-key` attribute to include your Tiny Cloud API key. For more information: [Using TinyMCE with Web Component - Cloud CDN](https://www.tiny.cloud/docs/tinymce/latest/webcomponent-cloud/) ### Self hosted via NPM package Using TinyMCE from NPM with the Web Component integration requires a couple of extra steps. See the documentation for more information: [Using TinyMCE with Web Component - Self hosted via NPM](https://www.tiny.cloud/docs/tinymce/latest/webcomponent-pm/) ## Detailed documentation * [TinyMCE Web Component Technical Reference](https://www.tiny.cloud/docs/tinymce/latest/webcomponent-ref/). * [TinyMCE Documentation](https://www.tiny.cloud/docs/tinymce/latest/). ## Issues Have you found an issue with `tinymce-webcomponent` or do you have a feature request? Open up an [issue](https://github.com/tinymce/tinymce-webcomponent/issues) and let us know or submit a [pull request](https://github.com/tinymce/tinymce-webcomponent/pulls). *Note: for issues concerning TinyMCE please visit the [TinyMCE repository](https://github.com/tinymce/tinymce).* ## License `tinymce-webcomponent` is licensed under the MIT License. See the LICENSE.txt file for details. Depending on use case, the TinyMCE core editor can be used under either GPL-2.0-or-later or a commercial license. See the [tinymce package](https://www.npmjs.com/package/tinymce) for details.