Repository navigation
Releases
v0.57.0
0.57.0 (2026-10-30)
This release brings two major features:
- Version sidebar updates: See who made changes with clearer author labels, and navigate version history using the keyboard. 💖 Sponsored by DINUM 🇫🇷.
- Localized emoji picker: We’ve switched to Frimousse for a better picker experience. Emoji names and search are localized to your language, with keyboard navigation and skin-tone selection. Localized emoji data is loaded on demand, so every locale isn’t included in the initial bundle.
frimousse-emoji-picker.mp4
🚀 Features
- core: Accept extensions in createInlineContentSpec (#3253)
- core: Improve Word and Google Docs paste handling (#3226)
- Improve version history authors and keyboard navigation (#3229)
- server-util:
⚠️ Allow swappable DOM environments (#3237) - react: Switch to the localized Frimousse emoji picker, with on-demand locale data (#3120, #3121)
🔥 Performance
- core: faster table building using occupancy grid (#3262)
- typst: Reuse content-addressed WASM builds (#3268)
🩹 Fixes
- core: Restore undo of autoformat conversions (#3164)
- docx: Avoid private numbering APIs and simplify layout mappings (#3225)
- core: Keep the browser's default link styling under CSS resets (#3060)
- core: Register Mod-Alt-c code block shortcut (#3242)
- math-block:
⚠️ Move CSS to @blocknote/math-block/style.css (#3238) - math: Native text input and deletion in an empty inline math source (#3240)
- core: Keep inline styles valid in md export with spaces (#3233)
- core: Register inline content spec extensions and mount their content correctly (#3251)
- docx: Preserve XML escaping in math equations (47915324cf)
- react: Preserve native input in empty inline content (#3254)
- core: Restore file upload button after failed drop or paste (#3247)
- core: Formatting toolbar stuck after a tap on iOS Safari's address bar (#3259)
- core: Display drag previews in Firefox and Safari (#3235)
- core: Insert & upload all files that are dropped or pasted (#3213)
- core: Separate blocks with newlines in getSelectedText (#3210)
- core: Strip comments from copied text (#3260)
- core: Keep the editor focused dropping & moving blocks (#3231)
- core: Install nested extension plugins at runtime (#3236)
- core: Handle in Markdown list item (#3194)
- react: Fast typing no longer breaks suggestion menus (#3249)
- shadcn: Better open menu drag dropdown behavior (#3074)
- math: Math/diagram errors are now selectable (#3148)
⚠️ Breaking Changes
- build: Packages are now ESM-only; CommonJS
require()is no longer supported. (#3118) - server-util: Pass a DOM
DocumenttoServerBlockNoteEditor.createwhen using DOM-dependent operations in Node, unless DOM globals are already available. (#3237) - math-block: Import
@blocknote/math-block/style.cssin your app to style math blocks. (#3238) - react: The legacy grid emoji-picker API has been removed. Use
EmojiPickerControllerfor emoji selection orSuggestionMenuControllerfor custom item collections. (#3121)
❤️ Thank You
- Yousef (@YousefED)
- Matthew Lipski (@matthewlipski)
- Ben Sauer (@sauerben)
- Safa Oueslati (@safaweslati)
- Jayesh Kugsiya (@jkugsiya)
- Adarshsm (@adarshsm)
- Fer2d2 (@fer2d2)
- Nick The Sick (@nperez0111)
- Rovshan Muradov (@RovshanMuradov)
- Galthran-wq (@galthran-wq)
- Raphael Fakhri (@RaphaelFakhri)
v0.56.0
0.56.0 (2026-10-14)
This release brings two major features:
- Layout blocks & block frames (preview): custom blocks that hold and arrange other blocks, such as tabs, steppers and alerts with a body. 💖 Sponsored by XWiki.
- Version history overhaul: a new history sidebar, version comparisons with author attribution, and a YHub storage backend. 💖 Sponsored by DINUM 🇫🇷.
See below for details. This release has breaking changes; see Breaking changes before upgrading.
🚀 Features
- Layout blocks & block frames (preview): custom blocks can now hold other blocks (
layoutOnly) and draw a frame around their content and children (renderFrame). (#3059) - Keyboard settings for custom blocks (experimental): set how Enter, Backspace and Shift-Tab work in a block with
experimental_keyboard. (#3059) - Toggles rebuilt: Enter in an open toggle adds a block inside it, a closed toggle keeps its children, you can drop blocks into a toggle (also an empty one), and the toggle button is accessible to screen readers. (#3059)
- Menus follow the schema: the slash menu and block type select show only the block types your schema supports, including only the configured heading levels. (#3059)
- Version history rebuilt, with customizable snapshot actions. (#3090)
- Side menu hover rewritten: the side menu now follows the block under the pointer, which fixes nested blocks, columns, scrolling containers and overlapping editors. New
hoverMarginanddropMarginoptions. (#3179) - Down arrow in a block without content at the end of the document creates a paragraph. (#3113)
- Better Backspace handling in nested blocks. (#3124)
- Mod+A shortcut changes. (#2995)
🔥 Performance
- Less layout shift when the Inter font loads. (#3130)
- Large version diffs show in one transaction. (#3090)
- Removed an unused source preview anchor. (#3099)
🩹 Fixes
- Suggestion menu: it opens below unless cramped, keeps its side and width while you filter, flips above when fewer than five items fit below, and doesn't jump when it scrolls. (#3188, #3190, #3198)
- Email exporter: text is escaped instead of being inserted as HTML. (#3100)
- Dropping a block into a toggle works with a real drag. (#3195)
- WebKit no longer scrolls when a block is dropped. (#3122)
- The formatting toolbar stays hidden when focus returns to editor UI. (#3187)
- A code block typed without a language uses the default language. (#3024)
- Inline code no longer clears comments. (#2832)
- Math previews open on the first click, and selected inline math is styled correctly. (#3129, #2983)
- Markdown autolinks round-trip. (#3115)
insertInlineContentno longer adds content after the cursor. (#3112)- No error when the placeholder style is already removed. (#3145)
- Block changes from before the view exists are no longer marked. (#3193)
⚠️ Breaking changes
Side menu
- By default, the side menu only shows while the pointer is over the editor (including its padding). Before, it also showed up to 250px around it. Set
sideMenu.hoverMarginto widen the area. (#3179)
Custom blocks & toggles
blockTypeSelectItems(dict)is nowblockTypeSelectItems(editor), because the items depend on the schema. (#3059)- Deprecated, still works:
meta.hardBreakShortcut. Useexperimental_keyboard.enterandexperimental_keyboard.shiftEnter. (#3059)
Behavior changes
- Mod+A now selects the current block first, and the whole document on the second press. Set
selectAllBehavior: "document"to select the whole document right away. (#2995) - Backspace at the start of a nested block now merges it into the block above, like a top-level block. It un-nests the block only when they can't merge. (#3124)
- A code block created without a language gets the configured
defaultLanguage("text"by default) instead of"". (#3024)
Imports
@blocknote/coreno longer exports the built-in extensions (including versioning) orUniqueIDfrom its root. Import them from@blocknote/core/extensions.getDefaultSlashMenuItems,filterSuggestionItems,insertOrUpdateBlockForSlashMenuandgetDefaultEmojiPickerItemsstay in the root. (#3090)- The versioning components (
VersioningSidebar,useVersionUsers) moved from@blocknote/reactto@blocknote/react/versioning. (#3090)
Versioning
- The versioning API is new. Apps using the previous API must migrate; see the versioning examples. (#3090)
Layout blocks & block frames (preview)
💖 This feature is sponsored by XWiki. Thanks for supporting BlockNote!
Layout blocks and block frames let you control how a block's children are rendered. With them, you can build block types that weren't possible before:
- Block frames:
renderFramedraws one frame around a block's content and its child blocks. - Layout blocks (
layoutOnly: true): blocks with no content of their own that hold and arrange other blocks. Columns are now built this way.
These APIs are a preview and can change before they're stable. We'd love your feedback in Discussions or an issue.
Tabs block
Stepper block
Alert block with a title and body
Version history overhaul
💖 This feature is sponsored by DINUM 🇫🇷
Version history has been rebuilt from the ground up:
- History sidebar: browse stored versions, newest first, and view any version read-only.
- Comparisons: compare a version with the previous one, with the start of the document, or with any other version. Hover a change to see who inserted, deleted or reformatted it, and when.
- Version actions: name, restore (the current content is saved first) and delete versions, or customize the actions with your own.
- YHub storage backend, faster diffs, and fixes for concurrent edits (nested blocks now merge correctly).
❤️ Thank you
- Matthew Lipski
- Yousef
- Nick Perez
- Adarshsm
- Rovshan Muradov
- Kevin Jahns (Yjs)
v0.55.0
0.55.0 (2026-09-22)
ScreenRecording_09-22-2026.19-06-09_1.mp4
This release, we have promoted the mobile formatting toolbar from experimental to supported. We recommend you to check our Mobile compatibility getting started guide for more information.
We now have a formattting toolbar that tries to show above the virtual keyboard of your mobile device (ios & android), allowing you to access formating options like changing the block type, bold, italics and more.
💕 This work was supported by the European Commission (see below)! 💕
🚀 Features
🩹 Fixes
- core: Link lookups at the edges of a link (#3058)
- a11y: Commit popover forms through submit, not a key handler (#3030)
- core: Enter on Android and iOS, toolbar and side menu fixes on phones (#3031)
❤️ Thank You
- Matthew Lipski (@matthewlipski)
- Yousef yousefdardiry@gmail.com
- Nick The Sick (@nperez0111)
💕 Credits
BlockNote receives financial support from the European Commission's Open Internet Stack initiative, under the support of DG Communications Networks, Content and Technology under grant agreement No 101298715 within the ELFA consortium.
v0.54.2
0.54.2 (2026-09-09)
🩹 Fixes
- xl-typst-compiler: Package wasm without Rust build artifacts (220544ffd)
❤️ Thank You
- Nick The Sick (@nperez0111)
v0.54.1
0.54.1 (2026-09-09)
🚀 Features
- Typst-powered accessible PDF export (PDF/UA-1) (#2992)
- pdf: base PDF export on self-hosted Typst compiler (#3020)
🔥 Performance
- core: Resolve block changes from changed range only (#2981)
🩹 Fixes
- xl-docx-exporter: Use distinct bullet symbols per nesting level (#2977)
- core: Only attach table handles to actual table blocks (#2972)
- xl-docx-exporter: Give each list its own numbering instance (#2976)
- exporters: Editor-parity rendering fixes + shared-document ground truth tests (#3021)
- core: Stop schema.extend() mutating the shared default specs (#3039)
- mantine: Restore compact AI menu items (#3027)
- Ignore only Dark Reader's writes in node views (#3062)
❤️ Thank You
- Yousef yousefdardiry@gmail.com
- Adarshsm adarshmudugal@gmail.com
- Nick Perez nick@blocknotejs.org
v0.54.0
0.54.0 (2026-08-13)
💖 The math block and diagram block has been sponsored by DINUM 🇫🇷
Math Block
A long requested feature, you can now add block & inline math to a BlockNote editor. They are driven by Katex & support much of Latex for all your notation needs.
math-block.mp4
Diagram Block
We've also added support for a diagram block driven by Mermaid.js, allowing you to add diagramming to the editor.
diagram-block.mp4
Source Block with Preview
Both the Math block & Diagram block are built on a primitive that you can build your own custom blocks from. The Source Block with Preview primitive allows you to build a pair of a block which renders content with an inline editor for the content being rendered. This can enable other sorts of preview-like features in the future, exposed as an API for you to build your own custom blocks with.
🚀 Features
- Adds a Math block (2a34f7d70)
- Adds a Diagram block (0fca0ee7a)
- core: Source-with-preview, syntax highlighting & exporter images (503c796d3)
🩹 Fixes
- ai: Operations on collaborative documents (#2952)
- ai: Operations on blocks containing comments (#2953)
- pdf: Add custom font and fontFamily options for CJK (#2945)
- Expose first suggestion as active descendant (#2965)
- xl-docx-exporter: Clamp list nesting to the levels DOCX defines (#2969)
❤️ Thank You
- Adarshsm adarshmudugal@gmail.com
- Nick The Sick (@nperez0111)
- Pupuking723 2318857637@qq.com
v0.53.0
0.53.0 (2026-08-06)
🚀 Features
- shadcn:
⚠️ Use base-ui instead of radix (BLO-1279) (#2913)
🩹 Fixes
- getCellSelection throwing error in positions (BLO-1193) (#2911)
- Multi-column slash menu items within a column (BLO-905) (#2914)
- Suggestion menu behaviour (BLO-1283, BLO-955) (#2930)
- Ignore useless block/inline content mutations (BLO-1224) (#2912)
- slash-menu: Better overflow behavior (BLO-1192) (#2909)
- Slash menu item selection behaviour (BLO-1222) (#2838)
- HTML export/parse round trip ignoring empty blocks (BLO-873) (#2931)
- core: Guard getBlock() calls to prevent TypeError on stale blocks (#2941)
- Stop stale node view positions crashing the editor (#2938)
- Multi-column trailing blocks, column hover borders & drop cursor left edge BLO-1226 (#2885)
⚠️ Breaking Changes
- shadcn:
⚠️ Use base-ui instead of radix (BLO-1279) (#2913)
❤️ Thank You
- Yousef yousefdardiry@gmail.com
- Nick Perez nick@blocknotejs.org
- Matthew Lipski (@matthewlipski)
v0.52.1
0.52.1 (2026-07-20)
🩹 Fixes
- react: Avoid importing yjs in the default UI (#2902)
❤️ Thank You
- Nick Perez nick@blocknotejs.org
v0.52.0
0.52.0 (2026-07-20)
🚀 Features
- Migrate to Vite+ (#2745)
- Decouple yjs from blocknote/core (#2741)
moveBlocksbehaviour when leaving empty columns (BLO-1109) (#2842)- comments: Confirm before discarding an unsaved comment (blo-1197) (#2861)
- core: Support "plain" block content (BLO-335) (#2868)
⚠️ Migration Guide
Yjs is now decoupled from @blocknote/core. Instead of passing a collaboration option directly to the editor, you now wrap your editor options with the withCollaboration helper imported from @blocknote/core/yjs.
Before (< 0.52.0):
const editor = useCreateBlockNote({
// ...other editor options
collaboration: {
provider,
fragment: doc.getXmlFragment("document-store"),
user: {
name: "My Username",
color: "#ff0000",
},
},
});After (>= 0.52.0):
// Import the helper from the decoupled Yjs entrypoint:
import { withCollaboration } from "@blocknote/core/yjs";
const editor = useCreateBlockNote(
withCollaboration({
// ...other editor options
collaboration: {
provider,
fragment: doc.getXmlFragment("document-store"),
user: {
name: "My Username",
color: "#ff0000",
},
},
}),
);The collaboration object itself (provider, fragment, user, showCursorLabels, etc.) is unchanged — you only need to:
- Import
withCollaborationfrom@blocknote/core/yjs. - Wrap your editor options object with
withCollaboration(...), keeping thecollaborationproperty inside it.
The same applies when creating an editor with BlockNoteEditor.create(withCollaboration({ ... })).
🩹 Fixes
- Align side menu to tables (BLO-1117) (#2837)
- Remove cursor flicker in trailing block (#2839)
- table: Guard stale block after changes for table handles (#2821)
- xl-ai: Remove 'use client' from server entry (BLO-1235) (57596cee6)
- tables: Tab causing indent in last table cell (BLO-1211) (#2831)
- core: Use dynamic propSchema when extending default block specs (#2882)
- xl-pdf-exporter: Fix emoji rendering for ZWJ sequences in PDF export (#2871)
- core: Ignore synthetic mousemove events without coordinates in side menu (#2895)
- core: Read hardBreakShortcut from block spec impl (#2891)
- xl-email-exporter: Update react-email deps to fix fresh install tests (#2898)
- core: Call scrollIntoView() on Enter (#2802)
❤️ Thank You
- Nick The Sick (@nperez0111)
- Luc H wereld03@gmail.com
- Nick Perez nick@blocknotejs.org
- Yousef yousefdardiry@gmail.com
- Matthew Lipski (@matthewlipski)
- Alex Yang (@himself65)
- Yousefed yousefdardiry@gmail.com
- Satoren satoreyo@hotmail.com
v0.51.4
0.51.4 (2026-06-02)
🩹 Fixes
- add explicit type annotations for callback params losing contextual typing (#2815)
- Comments emoji picker button issues (BLO-1199) (#2769)
- core: add editor cleanup in BlockNoteEditor.test.ts to prevent unhandled DOMObserver errors (#2816)
- table: prevent crash when pressing Enter in a table cell (#2793)
❤️ Thank You
- Matthew Lipski @matthewlipski
- Nick Perez
- Nick the Sick @nperez0111
- Yuki Terashima @y-temp4