> For the complete documentation index, see [llms.txt](https://docs.umbraco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umbraco.com/umbraco-cms/17.latest/model-your-content/property-editors/built-in-umbraco-property-editors/rich-text-editor/configuration.md).

# Configuration

In this article you can learn about the different options you have for configuring the Rich Text Editor (RTE).

## Toolbar

You have full control over which options should be available on the RTE.

![Toolbar: All options enabled](https://2050077833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb0WSXUuM7Qx5BfREagAI%2Fuploads%2Fgit-blob-b82806c78ea39ef75feff4c2e43d3f2997ddff2b%2Frte-tiptap-all-toolbar-items.png?alt=media)

In the example above, all the options have been enabled. These options include font styles like bold and italics, bullet lists, and options to embed videos and insert images.

You can customize the look of the toolbar:

* Enhance the capabilities of the toolbar by enabling or disabling extensions.
* Use the Toolbar designer to group together items and add additional rows if needed.

![Enhance and customize the capabilities of the Rich Text Editor toolbar](https://2050077833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb0WSXUuM7Qx5BfREagAI%2Fuploads%2Fgit-blob-1b348a9347df8fd32f6146835716618cef6a8483%2Frte-tiptap-capabilities-and-toolbar.png?alt=media)

## Statusbar

As well as the toolbar, you can configure extensions for the statusbar.

![Statusbar with Word Count extension enabled](https://2050077833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb0WSXUuM7Qx5BfREagAI%2Fuploads%2Fgit-blob-f05ec89ee054bafb8d9e483007c9e3a3202d9aec%2Frte-tiptap-statusbar.png?alt=media)

## Stylesheets

To apply custom styles to the Rich Text Editor, you can select from any existing stylesheets.

Stylesheets can be created in the **Settings** section. To learn more about this feature, see the [Stylesheets in the Backoffice](/umbraco-cms/17.latest/develop-with-umbraco/templating-and-rendering/design/stylesheets-javascript.md) article.

## Dimensions

Define `height` and `width` of the editor displayed in the content section.

## Maximum size for inserted images

Define the maximum size for images added through the Rich Text Editor.

If inserted images are larger than the dimensions defined here, the images will be resized automatically.

## Overlay Size

Select the width of the link picker overlay. The overlay size comes in three sizes: Small, Medium, Large, and Full.

## Available Blocks

Blocks can be added as elements in the Rich Text Editor. Configuration and rendering of Blocks are described in the [Blocks in Rich Text Editor](/umbraco-cms/17.latest/model-your-content/property-editors/built-in-umbraco-property-editors/rich-text-editor/blocks.md) article.

## Accepted Media Types

![Accepted media types configuration](https://2050077833-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb0WSXUuM7Qx5BfREagAI%2Fuploads%2Fgit-blob-b32feddee4ac855849c7eb8eb6b93ad04f0188e4%2Frte-tiptap-accepted-media-types.png?alt=media)

By default, only Image and Vector Graphics media types are accepted in the Rich Text Editor. You can change this by selecting specific types in the **Accepted media types** setting.

Only matching media types can be picked from the library or uploaded via the toolbar and drag-and-drop.

If an uploaded file matches multiple accepted media types, a picker dialog lets the editor choose the correct type.

## Image Upload Folder

Images added through the RTE are by default added to the root of the Media library.

Sometimes you might want to add the images to a specific folder. This folder can be configured using the "Image Upload Folder" setting.

## Ignore User Start Nodes

Some of the backoffice users might be restricted to a specific part of the content tree. When the "Ignore User Start Nodes" is checked, the users can pick any piece of content from the content tree, when adding internal links through the RTE.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.umbraco.com/umbraco-cms/17.latest/model-your-content/property-editors/built-in-umbraco-property-editors/rich-text-editor/configuration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
