Skip to content

Commit 7e41a2b

Browse files
committed
First iteration of swapping RTE UI
1 parent 11cc5e8 commit 7e41a2b

File tree

5 files changed

+49
-1
lines changed

5 files changed

+49
-1
lines changed
Lines changed: 49 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,51 @@
11
# Change Rich Text Editor UI
22

3-
This article will explain how to change the UI used for the Rich Text Editor.
3+
{% hint style="info" %}
4+
Umbraco 15 ships with two UI options for working with rich text, Tiptap and TinyMCE. The latter will eventually be removed from the CMS.
5+
6+
This article will guide you through switching from using the TinyMCE UI to using the new Tiptap UI.
7+
{% endhint %}
8+
9+
The following steps will guide you through changing the property editor used for rich text on an existing Document Type.
10+
11+
## Create a new Data Type
12+
13+
The first step in this guide is to create a new Rich Text Editor Data Type using the Tiptap UI.
14+
15+
1. Navigate to the **Settings** section of the Umbraco Backoffice.
16+
2. Select **+** next to the Data Types folder.
17+
3. Select **New Data Type...**.
18+
19+
![Click on + next to the Data Types folder to create a new Data Type](images/rte-swap-new-data-type.png)
20+
21+
4. Give the new Data Type a name.
22+
5. Click **Select a property editor**.
23+
6. Choose **Rich Text Editor [Tiptap]**.
24+
25+
![Search for and choose the Rich Text Editor Tiptap UI](images/rte-swap-select-ui.png)
26+
27+
7. [Configure the Data Type](./configuration.md) to match your needs.
28+
8. **Save** the Data Type.
29+
30+
## Update the Document Type(s)
31+
32+
Once you have prepared the new Data Type you need to update the Document Types that should use it.
33+
34+
1. Expand the **Document Types** folder.
35+
2. Select a Document Type that needs to be updated.
36+
3. Click on the Property used for rich text.
37+
38+
![Click on the property used for rich Text in the Document Type editor](images/rte-swap-change-property.png)
39+
40+
4. Hover over the selected property editor and click **Change**.
41+
5. Search for the newly created Data Type and select it.
42+
43+
![Search for the new Data Type and select it](images/rte-swap-search-and-find-new-ui.png)
44+
45+
6. **Submit** the changes.
46+
7. **Save** the Document Type.
47+
8. Repeat steps 2-7 for each Document Type that needs to use the new Data Type.
48+
49+
## Verify your content
50+
51+
When you have updated all the relevant Document Types, it is recommend to verify the content that uses the rich text editor.
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)