---
title: Installing plugins to the editor for rich text fields
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

> **Note:** **Important**: The 'Paste from Word' functionality in CKEditor is no longer supported using the built-in button. The 'Paste from Word' functionality is only available using keyboard shortcuts _ctrl/cmd_ + _v_.

The [editor for rich text fields](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-the-editor-for-rich-text-fields.md) in Xperience 13 is implemented using [CKEditor](http://ckeditor.com/) version **4.25.0**.

If you wish to add custom functionality to the editor, you can install CKEditor plugins. Either search for existing plugins at <https://ckeditor.com/cke4/addons/plugins/all> or develop your own plugins.

> **Note:** **Important**: Xperience does not guarantee compatibility with third-party CKEditor plugins that are not included in the default installation. Some plugins may not work correctly within the Xperience administration interface.

Use the following process to add plugins to the Xperience CKEditor:

1. Copy the plugin's main directory into the **CMS\CMSAdminControls\CKeditor\plugins** folder of your Xperience project.
2. Edit the **config.js** file in the **CMS\CMSAdminControls\CKeditor** folder.
3. Use the following configuration to add plugins. The values added to **config.plugins** must match the names of the corresponding plugin folders.

   ```js

   CKEDITOR.editorConfig = function (config) {

       /* Custom plugins */
       config.plugins += ',codemirror,youtube,templates';

       ... 

   ```

   > **Note:** **Notes**:
   >
   > - The standard setting for adding CKEditor plugins (_config.ExtraPlugins_) cannot be used, because it is overridden by the Xperience implementation. You need to directly add plugins to the **config.plugins** value instead.
   > - Notice the comma at the start of the **config.plugins** value.
4. If the plugin uses additional buttons on the editor toolbar, you need to add them to the toolbar sets defined in **config.js**.
   - See [Personalizing the editor for rich text fields](https://docs.kentico.com/13/configuring-xperience/configuring-the-environment-for-content-editors/configuring-the-editor-for-rich-text-fields/personalizing-the-editor-for-rich-text-fields.md).
   - The button names that you need to add to the toolbar definitions usually match the plugin's _config.plugin_ value and folder name.
5. Add any additional **config.js** configuration settings required by the plugin.
6. Check the plugin's dependencies and install any required plugins or components.
7. Clear your browser's cache and test the editor functionality in your browser.

The installed plugin should now be available for all users working with the editor in Xperience (each user must clear their own browser's cache).