Changelog

v2.17.0

• Report a console error when a client attempts to send a WebSocket message that is >1 MB (which is not supported). Previously the client would silently fail in this scenario.

• Added a new client config option largeMessageStrategy to allow specifying the preferred strategy for dealing with messages that are too large to send over WebSockets. There now is a choice between:

  • default Don’t send anything, but log the error to the console.
  • split Split the large message up into smaller chunks (at the cost of sacrificing atomicity). Thank you @adam-subframe!
  • experimental-fallback-to-http Send the message over HTTP instead of WebSocket.

• Deprecated the unstable_fallbackToHTTP experimental flag (please set largeMessageStrategy="experimental-fallback-to-http" instead).

• Added <LiveblocksProvider largeMessageStrategy="..." /> prop to LiveblocksProvider. See above for possible options.

• Fix crash when a Composer is unmounted during its onComposerSubmit callback.

• Add new icons to <Icon.* />.

This release adds components and utilities to add an AI toolbar to your text editor, available in private beta.

• Add ai option to useLiveblocksExtension to enable (and configure) it.
• Add <AiToolbar /> component. (with <AiToolbar.Suggestion />, <AiToolbar.SuggestionsSeparator />, etc)
• Add default AI buttons in Toolbar and FloatingToolbar when the ai option is enabled.
• Add askAi Tiptap command to manually open the toolbar, it can also be invoked with a prompt to directly start the request when opening the toolbar. (e.g. editor.commands.askAi("Explain this text"))

Documentation

• @liveblocks/node-prosemirror documentation has been published. Use this package for editing Tiptap and ProseMirror documents on the server.
• @liveblocks/node-lexical documentation has been improved to match the ProseMirror docs.

Website

• New blog post: Which rich text editor framework should you choose in 2025?.

Contributors

Contributors include:

6 authors

v2.16.2

• Improve error message if hooks are accidentally called server side.

• Fix bug in Zustand typing in case the multi-argument form of set() is used. Thank you @hans-lizihan!

Website

• New blog post: Great agent experience starts with great collaboration.

Documentation

• Better info on initialStorage values.

Contributors

Contributors include:

5 authors

v2.16.1

• <Toolbar.Button /> and <Toolbar.Toggle /> now display their name visually if children and icon aren’t set.

Documentation

• Added missing 409 response to Initialize Storage REST API.
• Typo fixed in custom notification snippet.

Contributors

Contributors include:

3 authors

v2.16.0

We've created new toolbar elements that allow you to import a default floating toolbar in Tiptap and Lexical. It's also possible to use these APIs to build custom or static toolbars. We've updated a number of our examples to show how to do this.

Our error listener APIs will now receive more errors in general, including errors from using Comments & Notifications. Previously, these would only receive room connection errors from Presence, Storage, or Yjs. For example, now when creation of a thread fails, deletion of a comment fails, marking a notification as read fails, etc.

// ❌ Before: required a RoomProvider and would only notify about errors for that room// ✅ Now: requires a LiveblocksProvider and will notify about errors for any roomuseErrorListener((err: LiveblocksError) => {  /* show toast, or notify Sentry, Datadog, etc */});

See the Upgrade Guide for 2.16 to learn how to adapt your code.

We now support filtering threads by absence of metadata as well in useThreads({ query }) (or useUserThreads_experimental({ query })). For example, you can now filter threads that do not have a color attribute set in their metadata:

useThreads({  query: {    // Filter any "pinned" threads that don't have a color set    metadata: {      pinned: true,      color: null, // ✨    },  },});

See the Upgrade Guide for 2.16 to learn how to adapt your code.

• Automatically refresh Comments and Notifications when the browser window regains focus.

The error listener APIs will now receive more errors in general, including errors from using Comments & Notifications. Previously, these would only receive room connection errors from Presence, Storage, or Yjs.

// 👌 Same as before, but might now also receive errors related to Comments & Notificationsroom.subscribe("error", (err) => { ... });

• Most of the icons used in the default components are now usable as <Icon.* /> via import { Icon } from "@liveblocks/react-ui".

• Add <Toolbar /> and <FloatingToolbar /> components to simplify building editor toolbars. They come with default controls out-of-the-box based on what the editor they’re attached to supports, but they’re also heavily extendable and customizable. Use inner components like <Toolbar.Toggle /> and <Toolbar.Separator /> to extend the defaults with your own actions, or start from scratch while customizing some of the defaults via <Toolbar.SectionInline /> or <Toolbar.BlockSelector /> for example.

• Add isTextFormatActive and isBlockNodeActive utilities.

Examples

• Updated Next.js Starter Kit to use the new FloatingToolbar.
• Updated many text editor examples to use the new FloatingToolbar:
  • Advanced collaborative text editor (Tiptap)`.
  • Collaborative text editor (Tiptap).
  • Collaborative text editor (Lexical).
  • Text editor comments (Tiptap).
  • Next.js Tiptap editor.
  • Next.js Tiptap editor.

Dashboard

• Allow rate limit configuration for webhook endpoints.
• Fix download comments attachments action in text editor view from room detail page.

Contributors

Contributors include:

5 authors

2.15.2

• Fix useLayoutEffect warnings when using React versions lower than 18.3.0 and SSR.

• Fix memory leak in some hooks.

• Fix bug where querying metadata with useThreads() would not always reuse the cache correctly.

Website

• New blog post: What’s new in Liveblocks: December 2024.

Contributors

Contributors include:

3 authors

2.15.1

• Fix rollup config to always ensure "use client" directives are on top of files after build.

Contributors

Contributors include:

1 authors

v2.15.0

• Breaking: Drop support for React 17 (and 16). If you’re unable to upgrade React to 18 or higher, you can still continue to use Liveblocks 2.14.0, which is the last version to support React versions lower than 18.

• The published target for all Liveblocks packages is now ES2022 (up from ES2020). This should have a positive impact on your bundle size[*].

• Various internal refactorings and code cleanup.

[*] If you bundle for the browser, this should not be a problem, as all major browsers support ES2022. If however you're specifically targeting very old browsers (mostly IE), then you may need to configure your bundler (Webpack, rollup, esbuild, etc) to also down-compile code from dependencies inside node_modules for you, if you aren't already.

Website

• New blog post: A better way to email your users about unread content.

Examples

• Adjusted email templates to allow switching the logo more easily.
• Next.js Starter Kit improvements:
  • Renaming a document updates it immediately for everyone else.
  • Clicking outside of the rename input saves the new name.
  • Added tldraw's dark mode.
  • Added option to filter for canvas in the room listing.
  • Upgraded Liveblocks.
  • Fixed a z-index problem and added a hover style.

Documentation

• Upgrade guide for 2.15.
• Added links to email templates in guides and API reference.

Contributors

Contributors include:

3 authors

v2.14.0

• Add new functions prepareTextMentionNotificationEmailAsHtml and prepareTextMentionNotificationEmailAsReact to support text mention notification event for Lexical and Tiptap text editors and prepare data into email-ready formats.

v2.13.2

• Fix report text editor function's call. Now we wait for the room's status to be connected to report the text editor instead of reporting directly after room creation / loading.

• Fix report text editor function's call. Now we wait for the room's status to be connected to report the text editor instead of reporting directly after room creation / loading.

Examples

• New example: Text Editor Emails (Tiptap).
• New example: Text Editor Emails (Lexical).

Documentation

• New guide: How to send email notifications for unread text editor mentions.
• Improved thread metadata page.

Website

• New blog post: What's new in Liveblocks: November 2024.
• Revamped the Liveblocks blog:
  • Added the ability to switch between categories to find relevant posts.
  • Added the ability to search posts and filter results using tags.
  • Updated the layout with a table of contents, writer information, and featured posts.

Contributors

Contributors include:

2 authors

v2.13.1

• Improve the spacing consequences of --lb-line-height (introduced in 2.13.0) in some contexts.

Dashboard

• Multiple Tiptap editors are now supported in a room's Text Editor view.

Documentation

• Improved custom composer behavior code example.

Contributors

Contributors include:

3 authors

v2.13.0

• Add a formatting toolbar to Composer which appears when selecting text. It’s enabled by default in the default components and can also be custom built with new primitives (Composer.FloatingToolbar and Composer.MarkToggle) and new APIs (const { marks, toggleMark } = useComposer()).
• Add new --lb-line-height token to control the line height of main elements (e.g. comment bodies in comments and composers).
• Remove Timestamp export mistakenly added to @liveblocks/react-ui, it should be imported from @liveblocks/react-ui/primitives instead.

Website

• New blog post: Easy collaborative text editing with Liveblocks Tiptap.

Examples

• New example: Novel AI editor.

Documentation

• Info on using multiple Tiptap editors.
• Info on offline support for Tiptap.
• Removed beta warnings from Tiptap docs.
• Improved resolveUsers and resolveRoomsInfo docs.
• Fix custom composer behavior code snippet.

Contributors

Contributors include:

3 authors