Skip to main content

Why does the Rich Text Editor look different after upgrading? (TinyMCE and Tiptap)

The Rich Text Editor changed engine in Umbraco 16: TinyMCE was removed and the editor is now built on Tiptap. What that means for guidance written for older versions, and what the editor's configuration options are called now.

Written by Joana Knobbe

Type: FAQ
Category: Umbraco CMS > Versions & Upgrades
Tags: rich text editor, RTE, Tiptap, TinyMCE, v16, v17, upgrade, breaking change, blocks, property editor, backoffice

Product: Umbraco CMS
Version: v16 and later


Why does the Rich Text Editor look different after upgrading, and is it still TinyMCE? It is not. From Umbraco 16 the TinyMCE option is removed, and the Rich Text Editor is built on Tiptap. If you upgraded from Umbraco 13, the editor you now see is a different engine, not a reconfigured version of the old one.

Why this matters when you search for help

Umbraco's documentation is published per major version, and a lot of Rich Text Editor material online was written for Umbraco 13 or earlier. That material describes TinyMCE.

If you are on Umbraco 16 or later and following a guide that mentions TinyMCE, TinyMCE plugins, or TinyMCE-specific settings, that guide does not describe your editor. The settings it names may not exist in your backoffice at all, and following it will not resolve what you are seeing.

Check which major version you are on before applying any Rich Text Editor guidance, and check which version the guidance was written for.

What the configuration options are called now

On the Rich Text Editor data type in Umbraco 17, the available configuration options are:

Option

What it controls

Toolbar

Which options are available on the editor toolbar

Statusbar

Statusbar extensions, such as word count

Stylesheets

Which existing stylesheets the editor uses

Dimensions

Height and width of the editor

Maximum size for inserted images

Size limit for images added through the editor

Overlay Size

Width of the link picker overlay — Small, Medium, Large or Full

Available Blocks

Which element types can be inserted as blocks

Accepted Media Types

Which media types may be inserted; defaults to Image and Vector Graphics

Image Upload Folder

Where media added through the editor is stored

Ignore User Start Nodes

Whether editors may pick content from anywhere in the content tree

If you are looking for a TinyMCE setting by name and cannot find it, it is likely that the setting no longer exists rather than that it has moved.

Blocks in the Rich Text Editor

Blocks let you insert structured content inside rich text. They are Element Types, created under Settings > Document Types, then made available on the Rich Text Editor data type under Available Blocks. Editors insert them from the toolbar.

On the front end, each block renders from a Partial View in Views/Partials/RichText/Components/. The view filename must match the Element Type alias exactly, or the block will not render.

Blocks in the Rich Text Editor use a different folder structure from Block List components, so a view in the Block List location will not be picked up here.

Getting help

If something in the Rich Text Editor is not behaving as expected after an upgrade, it helps to tell us:

  • your exact Umbraco version, including the patch number

  • what you see in the editor, and what you expected

  • whether the affected content was created before or after the upgrade

Recommended documentation


Last updated on September 09, 2026

Did this answer your question?