# 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="/files/j0GaHjzb9axpR1wPP0rG" 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="/files/r0dAo7ZduzXD0cWJJ77t" 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.<br>

   <figure><img src="/files/IWXteXBSsJ09htAETeOT" alt=""><figcaption><p>Showing test filters</p></figcaption></figure>

   <figure><img src="/files/lp3SXOTvDy8IckIPWchR" 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.*<br>

<figure><img src="/files/krUzLkIyfF3fLiiqsVa1" 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?


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://salsa-digital.gitbook.io/govcms-site-builder/unit-5-text-formats-and-rich-text/text-formats-and-rich-text/exercise-5-1-set-up-the-rich-text-editor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.