# Exercise 5.1 (Optional): Set up the Rich Text editor

In this exercise you’ll learn how to set up the rich text editor.

## Configure the Rich Text editor

1. Make sure you’re logged in as a user with the role that allows editing of text formats.
2.  Go to _Configuration_ → _Content authoring_ → **Text formats and editors**.

    <figure><img src="https://3186608908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzAsrTcKaHnLDg-7ALW%2Fuploads%2FhCg9C4hU4xQP5kGUqqBm%2Fimage.png?alt=media&#x26;token=5b7edc9b-4111-4649-99fe-72b065aed860" alt=""><figcaption><p>Text Format page</p></figcaption></figure>
3. Click the **Configure** link in the Operations column next to _Rich text_.
4. Review the Roles section, which allows you to configure the roles allowed to access Rich text format.
5.  The Toolbar configuration allows you to manage editor buttons/plugins.



    > **As a rule,** give users as few buttons as possible, for as long as possible.

    <figure><img src="https://3186608908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzAsrTcKaHnLDg-7ALW%2Fuploads%2Fgit-blob-cd945b84aad40ebea7a5617378e8f9f09b24a1a6%2FEx-5-1-Text-Formats-Editors-2.png?alt=media" alt=""><figcaption></figcaption></figure>
6. The **CKEditor plugin settings** allow you to configure some additional options, such as **Embed Media**.
7.  Check the **Enabled filters** section.



    Note that the **Limit allowed HTML tags and correct faulty HTML** option is selected. It’s important to keep this options enabled for **increased security**.

    If additional HTML tags are required to be supported, update the **Allowed HTML tags** field with the tags that you need. Avoid whitelisting the \<script> tag, since it may introduce a backdoor to malicious scripts.\


    <figure><img src="https://3186608908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzAsrTcKaHnLDg-7ALW%2Fuploads%2FSNQU7GChqUIWGqN0xF3L%2Fimage.png?alt=media&#x26;token=c8de24f1-2d21-4aab-8d77-4a7510b8aeb3" alt=""><figcaption><p>Showing test filters</p></figcaption></figure>

    <figure><img src="https://3186608908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzAsrTcKaHnLDg-7ALW%2Fuploads%2FuIlltrV14TydwCpnw94J%2Fimage.png?alt=media&#x26;token=c31a158e-d67c-41f3-beba-741ba7183e00" alt=""><figcaption><p>Showing allowed html tags</p></figcaption></figure>
8. The **Filter processing order** section allows you to arrange the execution order of filters. Avoid modifying the default order unless necessary.

## Test the editor

Now you can test the editor out by creating a new _Page._\


<figure><img src="https://3186608908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzAsrTcKaHnLDg-7ALW%2Fuploads%2FDYc6wv4kYPUY7jLmYgk9%2Fimage.png?alt=media&#x26;token=d05d2400-d753-42f3-9ecf-710bfa3cd5a6" alt=""><figcaption><p>Body field of Page content</p></figcaption></figure>

1.  Add some text, and then make it bold. Also try adding a list, an image and a link.

    > **Tip:** You can get some sample images at Dynamic Dummy Image Generator: [http://dummyimage.com/](http://dummyimage.com)
2. Click **Save.**
3. See how your page looks. Is the page being displayed as you expected?
