Tiptap Editor stripping structural HTML tags (div, article) - How to configure schema/valid elements?

Hi everyone,

I’m currently working with Umbraco v17 and exploring the new Tiptap-based Rich Text Editor. I’ve encountered a critical issue regarding HTML persistence.

In previous versions (pre-v17), we could easily manage allowed tags using the valid_elements configuration for TinyMCE. However, in v17, when I manually add <div> or <article> tags via the HTML source code view, the editor automatically strips them out after saving or switching views.

Since Tiptap is schema-driven, I understand that these elements must be registered as extensions or allowed within the schema.

My questions are:

  1. What is the recommended way in Umbraco 17 to allow specific structural HTML tags like div or article in the RTE?

  2. Is there a way to configure this via appsettings.json, or do we need to register a custom Tiptap extension using the new Backoffice Extension API (UI-Store/Manifests)?

  3. Is there an equivalent to the old valid_elements or ExtendedValidElements for the new Tiptap implementation?

This is quite blocking for projects that require semantic HTML or specific layout wrappers inside the grid/RTE. Any guidance or code snippets would be greatly appreciated.

Thanks in advance!