Skip to content

Releases

v0.57.0

Choose a tag to compare

@github-actions github-actions released this 30 Oct 16:20
Immutable release. Only release title and notes can be modified.
v0.57.0
75595c3

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 Document to ServerBlockNoteEditor.create when using DOM-dependent operations in Node, unless DOM globals are already available. (#3237)
  • math-block: Import @blocknote/math-block/style.css in your app to style math blocks. (#3238)
  • react: The legacy grid emoji-picker API has been removed. Use EmojiPickerController for emoji selection or SuggestionMenuController for custom item collections. (#3121)

❤️ Thank You

v0.56.0

Choose a tag to compare

@github-actions github-actions released this 14 Oct 13:31
Immutable release. Only release title and notes can be modified.

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 hoverMargin and dropMargin options. (#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)
  • insertInlineContent no 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.hoverMargin to widen the area. (#3179)

Custom blocks & toggles

  • blockTypeSelectItems(dict) is now blockTypeSelectItems(editor), because the items depend on the schema. (#3059)
  • Deprecated, still works: meta.hardBreakShortcut. Use experimental_keyboard.enter and experimental_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/core no longer exports the built-in extensions (including versioning) or UniqueID from its root. Import them from @blocknote/core/extensions. getDefaultSlashMenuItems, filterSuggestionItems, insertOrUpdateBlockForSlashMenu and getDefaultEmojiPickerItems stay in the root. (#3090)
  • The versioning components (VersioningSidebar, useVersionUsers) moved from @blocknote/react to @blocknote/react/versioning. (#3090)

Versioning


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: renderFrame draws 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

Tabs block

Stepper block

Stepper block

Alert block with a title and body

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

Choose a tag to compare

@github-actions github-actions released this 22 Sep 17:15
Immutable release. Only release title and notes can be modified.
v0.55.0
e5e3079

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

  • Mobile formatting toolbar (BLO-1292) (#2939)
  • Enter saves comment in comment editor (#3103)

🩹 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

💕 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

Choose a tag to compare

@github-actions github-actions released this 09 Sep 09:41
Immutable release. Only release title and notes can be modified.
v0.54.2
fa7f7b8

0.54.2 (2026-09-09)

🩹 Fixes

  • xl-typst-compiler: Package wasm without Rust build artifacts (220544ffd)

❤️ Thank You

v0.54.1

Choose a tag to compare

@nperez0111 nperez0111 released this 09 Sep 09:44
Immutable release. Only release title and notes can be modified.
7320502

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

v0.54.0

Choose a tag to compare

@github-actions github-actions released this 13 Aug 15:40
Immutable release. Only release title and notes can be modified.
ea5d803

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

Link to demo

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

Link to demo

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.

a table being rendered from CSV source an inline CSS color picker

Link to demo

🚀 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

v0.53.0

Choose a tag to compare

@github-actions github-actions released this 07 Aug 06:38
Immutable release. Only release title and notes can be modified.
529c3b0

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

v0.52.1

Choose a tag to compare

@github-actions github-actions released this 20 Jul 15:10
Immutable release. Only release title and notes can be modified.
dee7880

0.52.1 (2026-07-20)

🩹 Fixes

  • react: Avoid importing yjs in the default UI (#2902)

❤️ Thank You

v0.52.0

Choose a tag to compare

@github-actions github-actions released this 20 Jul 09:58
Immutable release. Only release title and notes can be modified.
a99aab4

0.52.0 (2026-07-20)

🚀 Features

  • Migrate to Vite+ (#2745)
  • Decouple yjs from blocknote/core (#2741)
  • moveBlocks behaviour 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:

  1. Import withCollaboration from @blocknote/core/yjs.
  2. Wrap your editor options object with withCollaboration(...), keeping the collaboration property 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

v0.51.4

Choose a tag to compare

@nperez0111 nperez0111 released this 02 Jun 10:48
Immutable release. Only release title and notes can be modified.
3209491

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