Add a rich text editor to a Bubble app with Buildprint
Last updated 15 November 2026. For Bubble developers who build with the Buildprint CLI and its agents, and for the agents themselves.
Short answer
Install the Tiptap rich text editor plugin (plugin ID 1670612027178x122079323974008830), place its element with type 1670612027178x122079323974008830-AAC, and save its
contentHTML
state to a text field. It is a WYSIWYG editor built on
Tiptap
with HTML, JSON and plain-text output, autobinding, tables, images, mentions, math and 70 element actions. Turn on real-time collaboration with WhoIsTyping when several people edit the same document.
Prompt for your agent
Paste this into a Buildprint agent chat or your own coding agent:
Add a rich text editor to my Bubble app. Use the Tiptap plugin
(ID 1670612027178x122079323974008830). Follow
https://whoistyping.wtf/guides/bubble-rich-text-editor-buildprint
Work on a new branch, save the editor's HTML to a text field,
and run buildprint check before buildprint apply.
1. Install the plugin
Run these from the branch folder of a cloned app, such as my-app/feature-editor. Buildprint refuses plugin commands anywhere else.
buildprint plugin search tiptap.dev
buildprint plugin install 1670612027178x122079323974008830
The install syncs the plugin definition into plugins/
in the workspace. Its plugin.json
lists every element field, state, event and action with its BubbleScript key.
2. Add the editor
Put the element inside a group named Doc group
whose type and data source are the thing you edit. This example edits a Doc
with a text field HTML. Checked against plugin version 4.20.2.
plugin("bpedit01", {
type: "1670612027178x122079323974008830-AAC",
name: "Doc editor",
layout: { minHeight: 200, alignSelf: "stretch", minWidth: 0 },
properties: {
initialContent: arbitraryText(dynamicText("", parentThing().field("HTML"), "")),
isEditable: true,
placeholder: "Start writing…",
autoBinding: false,
file_upload_condition: false,
},
})
-
initialContenttakes HTML or plain text. An empty value does not clear the editor; run the Clear contents action for that. -
Always set
file_upload_condition(File uploads enabled) totrueorfalseexplicitly. -
isEditable: falseturns the same element into a read-only viewer.
3. Save the content
Pick one way per field. Do not use both on the same field.
Save button.
A workflow writes the contentHTML
state when the user clicks:
export default elementClicked("Save button", {
workflowName: "Save clicked",
actions: [
changeThing({
values: { HTML: element("Doc editor").state("contentHTML") },
thing: element("Doc group").groupData(),
}),
],
});
Autobinding.
Bind the element to the text field. Edits save after Autobinding save delay
(2200 ms by default) and when the editor loses focus. To save from a workflow without a button, use the element's
Content updated
event. With collaboration on, the plugin ignores autobinding: save with the button workflow or a webhook instead.
4. Check and apply
buildprint check
buildprint apply
Then open the branch in run mode, type, save, and reload. The text and its formatting should come back.
5. Real-time collaboration
For several people typing in one document, with live cursors and names, turn on Enable collaboration? and connect a WhoIsTyping project with the Custom provider. Collaboration needs a Document Server ID, a secret in the plugin settings and a workflow that generates the auth token once the user is signed in. Leave autobinding off for a collaborative document. Follow the Bubble collaboration setup guide for those steps; the secret must stay in the server-side plugin setting, never in page text or BubbleScript. The free tier includes one project and five documents.
An agent can do the WhoIsTyping side itself through the WhoIsTyping MCP server: create a project, read its Document Server ID and secret, list documents and test webhooks, after you approve its access once in the browser.
Reference
| What | BubbleScript |
|---|---|
| Plugin ID | 1670612027178x122079323974008830 |
| Element type (released plugin) | 1670612027178x122079323974008830-AAC |
| Content states |
contentHTML, contentJSON, contentText
|
| Load content | initialContent |
| Read-only | isEditable: false |
| Save event (element, event name) | "Doc editor", "Content updated" |
Choosing between editors first? Read the rich text editor comparison. Live demo of every feature: Tiptap plugin demo. Plugin listing: Bubble Marketplace .