Documentation

Reference

Toolbar & Menu Items Reference

Every toolbar, subtoolbar, and control-selection item the editor recognizes — the vocabulary for building custom config.toolbar strings. Use these identifiers verbatim.

Toolbar string syntax

Compose a toolbar by combining item IDs with the following grammar:

  • a,b,c — adjacent items
  • {a,b,c} — grouped (visual separator before / after)
  • a|b|c — separator between items
  • a/b/c — wrap to a new row
  • #{a,b} — align to the right
  • a:toggle — split button that toggles on click
  • a:dropdown — forced dropdown style
  • [a,b] — section inside a ribbon group

Example:

config.toolbar = "mycustom";
config.toolbar_mycustom = "{bold,italic,underline}|{forecolor,backcolor}|{insertlink,insertimage}|undo,redo";

Built-in presets 6

Pass config.toolbar = "<name>" to use a preset instead of a custom string.

PresetDescription
defaultMost commonly used buttons; sensible default for most apps.
basicMinimal set: bold/italic/underline, font, link, image, video, removeformat, code.
fullEvery desktop item, including merge-fields, footnotes, TOC, page break, revision history.
mobileCompact single-row layout for phones; auto-swapped in at maxWidthForMobile.
officeRibbon layout mimicking Microsoft Word with Common / Format / Paragraphs / Insert tabs.
richtextboxjsAlias for full; kept for backward compatibility.

Formatting 21

IDDescription
boldToggle bold on the selection (Ctrl+B).
italicToggle italic (Ctrl+I).
underlineToggle underline (Ctrl+U).
underlinemenuUnderline split button with styles dropdown.
strikeStrikethrough.
superscriptRaise text as superscript.
subscriptLower text as subscript.
forecolorText color picker.
backcolorBackground / highlight color picker.
fontnameFont family dropdown.
fontsizeFont size dropdown.
paragraphsParagraph format dropdown (Normal, Heading 1-6, etc.).
paragraphstyleParagraph CSS-class styles dropdown.
stylesCombined inline + block styles dropdown.
inlinestyleInline CSS-class styles dropdown.
linkstyleLink CSS-class styles dropdown.
imagestyleImage CSS-class styles dropdown.
lineheightLine-height picker.
changecaseChange case (UPPER / lower / Title).
ucaseConvert selection to UPPERCASE.
lcaseConvert selection to lowercase.
removeformatStrip all inline formatting from the selection.
cleancodeClean messy Word / paste HTML.
formatpainterCopy formatting from one passage and apply to another.

Paragraph & alignment 9

IDDescription
justifyleftAlign selection left.
justifycenterCenter alignment.
justifyrightAlign right.
justifyfullJustify (both sides).
justifymenuAlignment dropdown (combines all four).
ltrLeft-to-right paragraph direction.
rtlRight-to-left paragraph direction.
insertlinemenuInsert line-break style menu.
menu_paragraphopCombined paragraph operations menu.
toggle_paragraphopToggle the paragraph-operations subtoolbar.

Lists & structure 9

IDDescription
insertorderedlistOrdered (numbered) list.
insertunorderedlistUnordered (bulleted) list.
insertchecklistTodo-style checklist.
indentIncrease paragraph indent.
outdentDecrease paragraph indent.
insertblockquoteWrap selection in a blockquote.
inserthorizontalruleHorizontal divider line.
insertpagebreakPage break for print / PDF.
inserttocAuto-generated table of contents from headings.

Insert 14

IDDescription
insertlinkInsert hyperlink (Ctrl+K).
unlinkRemove hyperlink from selection.
insertanchorInsert a named anchor (for in-page links).
insertemojiEmoji picker.
insertcharsSpecial character picker.
insertcodeCode snippet inserter.
syntaxhighlighterInsert syntax-highlighted code block.
inserttemplateInsert from a list of HTML templates.
insertdocumentInsert external document content.
insertmergefieldInsert a mail-merge field placeholder.
insertfootnoteInsert a numbered footnote at the cursor.
insertdateInsert today’s date.
insertcommentLegacy inline comment (separate from v2 threaded comments plugin).
insertimagemapInsert an image map (clickable regions).

Media 8

IDDescription
insertimageOpen the image dialog (upload, URL, gallery).
insertgalleryInsert from the server-side image gallery.
imageeditorOpen the selected image in the built-in editor (crop, rotate, filter).
imagecaptionAdd / edit an image caption.
insertvideoEmbed a video (YouTube, Vimeo, URL).
insertyoutubeEmbed a YouTube video directly.
googlemapEmbed a Google Map.
html5Insert an HTML5 audio / video element.

Tables 15

IDDescription
inserttableOpen the insert-table dialog.
ribbontableTable ribbon button (for the Office preset).
tableheaderToggle a row as header.
menu_tablecellCell operations menu (merge / split / color).
menu_tablerowRow operations menu.
menu_tablecolumnColumn operations menu.
menu_tableWhole-table operations menu.
tablerowinsertaboveInsert row above current.
tablerowinsertbelowInsert row below current.
tablerowdeleteDelete current row.
tablecolumninsertleftInsert column left of current.
tablecolumninsertrightInsert column right of current.
tablecolumndeleteDelete current column.
tablecellmergeMerge selected cells.
tablecellsplitverSplit cell vertically.
tablecellsplithorSplit cell horizontally.
tablecellforecolorSet cell text color.
tablecellbackcolorSet cell background color.
tabledeleteDelete the entire table.

AI Toolkit 6

IDDescription
aiassistMain AI split button — opens Ask AI dialog with quick actions (Proofread / Rewrite / etc.).
aiassist_open_dialogDirect-open Ask AI dialog (no dropdown).
aiassist_chatToggle the docked AI Chat panel.
aiassist_reviewToggle the AI Review drawer (reviewable suggestions).
aiassist_proofreadDirect proofread action (no dialog).
aiassist_rewriteDirect rewrite action.
aiassist_translateDirect translate action.
aiassist_commentAsk AI to leave a comment on the selection.
aiassist_paragraphAsk AI to write a follow-up paragraph.
aiassist_justifyJustify / explain an edit via AI.

Collaboration & review 7

Most of these activate via typing (/, @) rather than toolbar buttons, but the IDs below are available for explicit placement.

IDDescription
slashcommandTrigger the slash-command inline picker. Also activates automatically on /.
mentionsTrigger the @mentions picker. Normally bound to @.
trackchangesToggle Track Changes (human suggesting mode) on / off.
commentsAdd a threaded comment on the selection.
revisionhistoryOpen the revision history browser (snapshots + diff).
dictationToggle speech-to-text dictation. Requires microphone permission.
html2pdfExport the document as PDF via the client-side html2pdf plugin.

Utility 24

IDDescription
cutCut selection to clipboard.
copyCopy selection.
pastePaste clipboard content.
pasteautoPaste with automatic cleaning.
pastetextPaste as plain text.
pastewordPaste from Word with format cleanup.
ribbonpastePaste split button for Office ribbon preset.
deleteDelete selection.
undoUndo last action (Ctrl+Z).
redoRedo.
findFind & replace dialog.
selectallSelect everything in the editor.
spellcheckToggle spell-check.
previewOpen a read-only preview of the current content.
codeToggle the HTML source view.
newdocClear the editor for a new document.
loadLoad content from a file.
saveTrigger the host form's save action.
printOpen the browser print dialog.
helpOpen the help dialog.
fullscreenenterExpand the editor to full-screen.
fullscreenexitExit full-screen.
fullscreenToggle full-screen (combined).
toggleborderToggle visible borders on table cells / elements.
togglemoreToggle the overflow “More” subtoolbar.
virtualkeyboardOpen an on-screen keyboard.
insertformInsert a form element.
insertboxInsert a content box.
insertlayerInsert a positioned layer.
insertfieldsetInsert a <fieldset>.
pagepropertiesEdit page-level properties (title, base URL, etc.).

Subtoolbars 11

Referenced as subtoolbar_<name>. You can override any of these in your config to customize the nested menus.

IDUsed by
subtoolbar_moreOverflow menu for the default toolbar.
subtoolbar_more_fullOverflow menu for the full preset.
subtoolbar_more_mobileOverflow menu for mobile preset.
subtoolbar_pastePaste split button dropdown.
subtoolbar_paragraphopParagraph operations dropdown.
subtoolbar_tableTable quick actions.
subtoolbar_tablerowRow operations.
subtoolbar_tablecellCell operations.
subtoolbar_tablecolumnColumn operations.
subtoolbar_tableinsertTable insert-directions dropdown.
subtoolbar_tabledeleteTable delete-directions dropdown.
subtoolbar_controlsizeResize handles for selected images / tables.
subtoolbar_justifyAlignment dropdown.
subtoolbar_controljustifyAlignment + float for selected images.
subtoolbar_floatparagraphFloating paragraph toolbar buttons.

Control-selection toolbars 4

Floating toolbars that appear when the user clicks a specific element. Override controltoolbar_<TAG> to customize.

IDShown when the user selects
controltoolbar_TEXTA plain text run (generic inline selection).
controltoolbar_AA hyperlink.
controltoolbar_TDA table cell.
controltoolbar_IMGAn image.

See also