> For the complete documentation index, see [llms.txt](https://salsa-digital.gitbook.io/govcms-site-builder/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://salsa-digital.gitbook.io/govcms-site-builder/unit-5-text-formats-and-rich-text/text-formats-and-rich-text.md).

# Text formats and rich text

Site editors need a CMS that’s easy to use so they can input content without HTML knowledge.

Out-of-the-box, GovCMS provides a Rich Text editor (**CKEditor**) for writing content.

Rich text editors ensure that content can be added quickly and easily by people who don’t have any HTML experience. Rich text editors give users the ability to add images, create links, make text formatting changes such as bold text, etc.

## About text formats and filters

Text formats change how HTML tags and other text is processed and displayed on your site. Text formats are composed of a series of filters, each of which transforms text. When users create content, a text format is associated with the content, and the full, original text is stored in the database. The content is then passed through the filters in the text format before it’s displayed on the site.

The core **Filter module** provides text format functionality, and the GovCMS installation profile sets up **Rich text** and **Plain text** text formats. Each text format has an associated permission, so that you can allow only trusted users to use permissive text formats. This restricts untrusted users to text formats like **Plain text**, which filters out dangerous HTML tags.

## About the editors associated with text formats

Each text format can be associated with an editor, such as a visual WYSIWYG (What You See Is What You Get) HTML editor. The core Text Editor module provides the ability to associate editors with text formats, and to configure the editors (such as adding and removing buttons from their toolbars). The core **CKEditor** module provides the industry-standard editor known as CKEditor, so that it can be used to edit HTML content on your site.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://salsa-digital.gitbook.io/govcms-site-builder/unit-5-text-formats-and-rich-text/text-formats-and-rich-text.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
