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
Rich Text Editor — CMS 17.latest
Last updated on September 09, 2026
