diff --git a/packages/ckeditor5-ui/docs/features/blocktoolbar.md b/packages/ckeditor5-ui/docs/features/blocktoolbar.md index a55c0a9dd0c..870e177a5ad 100644 --- a/packages/ckeditor5-ui/docs/features/blocktoolbar.md +++ b/packages/ckeditor5-ui/docs/features/blocktoolbar.md @@ -23,6 +23,8 @@ The block toolbar plugin provides an additional [configurable](#configuration) t To access the block toolbar, you need to click the button with braille pattern dots icon (`⠿`) on the left-hand side of the content area (the gutter). The button appears next to the selected block element (e.g. a paragraph), following the caret as the user edits the content and navigates the document. +The icon (`⠿`) is also a handle to drag blocks of content around the editor. E.g. click on a heading in the demo above and drag it all the way down between the following paragraphs to see this functionality in action. + The block toolbar complements the {@link installation/getting-started/predefined-builds#balloon-editor balloon editor} where it falls short, for example when you must insert some content (like an image), but the selection is collapsed, so you cannot access the toolbar. You can read more about it in the {@link installation/getting-started/predefined-builds#balloon-block-editor balloon block editor overview}. See the {@link examples/builds/balloon-block-editor balloon block editor example} page, too.