Release notes from BlockNote

v0.47.1

2026-03-02T11:56:26Z

0.47.1 (2026-03-02)

🩹 Fixes

typeerror cannot read properties of undefined (#2522)
handle more delete key cases (#2126)
add delay for data-active in collab cursors (#2383)
disable slash menu in table content #2408 (#2504, #2408)
ai: selections broken due to floating-ui focus manager (#2527)

❤️ Thank You

Matthew Lipski @matthewlipski
Nick Perez
Yousef

v0.47.0

2026-02-23T07:39:47Z

0.47.0 (2026-02-23)

🚀 Features

update suggestion menu component (#2397)
i18n: add Persian (fa) localization support (#2447)
i18n: add Uzbek (uz) localization support (#2506)

🩹 Fixes

prevent nested bullet list icon rendering as emoji on iOS 18+ (#2394, #2399)
ignore drag & drop from unrelated events #1968 (#2346, #1968)
disable checkbox when editor is not editable #2406 (#2448, #2406)
Backspace/enter behaviour in empty block with children (#2451)
handle pasting into table cells better, by collapsing their content to inline #2410 (#2449, #2410)
accessibility: ai combobox aria-activedescendant (#2413)
ai: no more scrolling to top when opening AI menu (#2503)
docs: unicode char not rendered in bug template (f13e270be)

❤️ Thank You

Cyril G @Ovgodd
Dex Devlon @bxff
Matthew Lipski @matthewlipski
MDSAM05 @MDSAM05
Mohammad RAHMANI @Mrahmani71
Nick Perez
Ogabek @OgabekYuldoshev
Wouter Vroege
Yousef

v0.46.2

2026-01-27T20:16:28Z

0.46.2 (2026-01-27)

This release ships a bunch of bug fixes, including many from the BlockNote community!

🩹 Fixes

deep merge floatingUIOptions using nested spread operators (#2310)
Visual differences between live editor and rendered exported HTML (#2348)
BlockNoteViewEditor mismatched editable value (#2357)
add font-synthesis for italic & bold in fonts that don't have them specified #2325 (#2354, #2325)
disable code block language selector when editor is not editable (#2351)
table handles would crash (#2384)
update CreateLinkButton to be able to toggle popover visibility (#2316, #2313)
add context,nestingLevel to toExternalHTML (#2373)
ai: re-enable flipping the AIMenu when there is not enough space #2245 (#2247, #2245)
link-toolbar: prevent Enter from submitting during IME composition (#2361)

❤️ Thank You

hanios123
Jean-Baptiste PENRATH
Matthew Lipski @matthewlipski
Nick Perez
Shohei Yoshida @ysds
Yousef

v0.46.1

2026-01-10T18:27:07Z

0.46.1 (2026-01-10)

This was a version bump for some invalid CSS

v0.46.0

2026-01-08T15:04:30Z

0.46.0 (2026-01-08)

The main feature of this release is now depending on the new Vercel AI SDK V6 (upgrade from V5) for our xl-ai package.
Other than that, this release was mainly bug fixes and dep upgrades to packages we depend on.

🚀 Features

add data-nesting-level to HTML export (#2329)
migrate to ai sdk 6 (#2328)

🩹 Fixes

emojipicker can sometimes fail to mount (575b81cec)
LinkToolbar Event Listener leak (#2335)
when you convert a block into checkListItem via inputRule, it should transfer its content into checkListItem content (#2331)
do not return focus back to menu (484d7da36)
arrow up on a checklist item should move to the element above BLO-362 (#2306)
getPos race condition in React StrictMode (#2311)
adjust input rules to be more tolerant to starting whitespace (#2341)
ai: make sure ShowSelection works (#2297)
xl-email-exporter: remove redundant sections in email export (#2323)

❤️ Thank You

Nick Perez
Nick the Sick @nperez0111
supernova @tmpluto
Yousef

v0.45.0

2025-12-17T12:25:10Z

0.45.0 (2025-12-17)

🚀 Features

ai: expand selections to contain words (#2304)
extensions: extensions can now include other extensions for grouping into one extension (#2284)

🩹 Fixes

an invalidly specified table should not crash the editor (#2255)
filter out invalid heading items based on the current block schema in the slash menu #2253 (#2259, #2253)
relax shiki package requirements #2279 (#2280, #2279)
filter the default tiptap extensions #2282 (#2283, #2282)
always include the cursor extension #2244 (#2260, #2244)
make onBeforeChange return the correct type again (9009369b1)
if there is no table block, there is no table handles to show #1055 (#2281, #1055)
pass dragHandleMenu prop to DragHandleButton (#2254)
html diff error with whitespace (#2230)
update regex for checklist items #2288 (#2305, #2288)
email-exporter: ReadableByteStreamController for safari react-email (#2295)

❤️ Thank You

Max @maqen
Nick Perez
Nick the Sick @nperez0111
Yousef

v0.44.2

2025-12-09T15:44:28Z

0.44.2 (2025-12-09)

🩹 Fixes

put back onBeforeChange method #2221 (#2243, #2221)
Improper accessing of editor DOM element (#2234)
make validation errors recoverable by llm (#2054)
shadowdom support and example (#2223)
ensure numbered list start property always present (#2241, #2242)
Suggestion menu positioning (#2232)
conditionally access the TableHandles extension from React (#2248)
ai: upgrade prosemirror-suggest-changes (#2235)

❤️ Thank You

Matthew Lipski @matthewlipski
Nick Perez
wcyat @sdip15fa
Yousef

v0.44.1

2025-12-08T16:55:24Z

0.44.1 (2025-12-08)

This release fixes some regressions from v0.43.0.

🩹 Fixes

clearing selection was not being called when create link button is no longer rendered (#2217)
AI menu not updating position on new line (#2233)
UI elements not scrolling when editor DOM element is scrollable (#2231)

❤️ Thank You

Matthew Lipski @matthewlipski

v0.44.0

2025-12-02T10:53:59Z

0.44.0 (2025-12-02)

This release brings several architectural improvements to BlockNote AI and introduces abort() functionality for AI requests.

See #2198 for details and breaking changes, or have a look at the updated docs.

We also fixed some build / dependency issues in 0.43.0.

What's Changed

refactor(ai): standardize prompt building by @YousefED in #2198
feat(ai): Abort requests by @YousefED in #2213
chore(build): fix AI packaging issue by @YousefED in #2210
chore: streamline all vite.config external options by @YousefED in #2214

Full Changelog: v0.43.0...v0.44.0

v0.43.0

2025-12-02T17:34:02Z

0.43.0 (2025-12-01)

Major Codebase Refactor

This release introduces a major refactor to the codebase, targeting 2 main areas of improvement:

UI Extensions, Components, and Hooks

BlockNote extensions responsible for UI elements like the formatting toolbar and file panel have been rewritten and heavily simplified. They take advantage of changes we've made to the BlockNote extensions API (see below), making them far more maintainable.

As part of simplifying the UI extensions, FloatingUI now handles much more in terms of positioning & dismissing the elements, e.g. making them scroll with the editor and close on hitting Escape.

Thanks to these changes, we've also been able to make our React components/hooks much simpler and more readable.

BlockNote Extensions

We've cleaned up and added additional functionality to BlockNote's extensions API. The original extension system was created somewhat haphazardly to support commonly needed features like keyboard shortcuts. The new BlockNote extensions API will be able to do much more, and should reduce the need to add functionality using TipTap extensions or ProseMirror plugins.

The additions to the extensions API are currently meant for internal use only, but we can't wait to share these with the community in a future release!

To see a detailed summary of the changes in this release, see PR #2143.

Breaking Changes

`@blocknote/core`

Existing extensions using the BlockNoteExtension class are no longer supported. Use the createExtension function instead.
Extension-specific imports have been moved from @blocknote/core to @blocknote/core/extensions. This includes helpers such as filterSuggestionItems for the suggestion menu extension.
Comment-specific imports have been moved from @blocknote/core to @blocknote/core/comments.
The comments editor option has been removed. Instead of passing comments: options to the editor, pass extensions: [CommentsExtension(options)] instead.
Extensions are no longer listed as properties of BlockNoteEditor, e.g. editor.formattingToolbar. Use the getExtension method instead, e.g. editor.getExtension(FormattingToolbarExtension).
editor.openSuggestionMenu has been removed. Use editor.getExtension(SuggestionMenu).openSuggestionMenu instead.
editor.getForceSelectionVisible/editor.setForceSelectionVisible have been removed. Use editor.getExtension(ShowSelectionExtension).store.state.enabled/editor.getExtension(ShowSelectionExtension).showSelection instead.
editor.onCreate has been removed. Use editor.onMount instead.
insertOrUpdateBlock has been renamed to insertOrUpdateBlockForSlashMenu.
editor.updateCollaborationUserInfo has been removed.

`@blocknote/react`

useEditorContentOrSelectionChange has been removed. Use useEditorState instead.
useUIPluginState has been removed. Use useExtension or useExtensionState instead.
useUIElementPositioning has been removed. Use BlockPopover, PositionPopover, or GenericPopover instead.
useEditorForceUpdate has been removed.

`@blocknote/xl-ai`

BlockPositioner has been removed. Use BlockPopover instead.
createAIExtension has been removed. Use AIExtension instead.
getAIExtension has been removed. Use editor.getExtension(AIExtension) or useExtension(AIExtension) instead.

Changelog

🚀 Features

Major Extensions & UI Refactor (#2143)

🩹 Fixes

allow configuring the email body's styles (#2182)
xl-docx-exporter: improve OOXML interoperability (#2206)

❤️ Thank You

Nick Perez
Stephan Meijer @StephanMeijer