Changelog

Dashboard

• Fix caching issue when editing notification settings.

Website

• New blog post: People and AI working together, in any app — the story behind Liveblocks 3.0.

Contributors

Contributors include:

3 authors

v3.0.0

Liveblocks 3.0 is our third major release, focusing on our newest product, AI Copilots. We’ve used this as an opportunity to tidy up some of our existing APIs, ensuring consistency throughout our offering.

For full upgrade instructions and codemods, see the 3.0 upgrade guide.

• TypeScript 5.0 is now the minimum supported version.

• Remove deprecated APIs, see the deprecated section in the upgrade guide to learn more.

• Introduce hooks and APIs for AI Copilots: useAiChats, useAiChat, useDeleteAiChat,useSendAiMessage, RegisterAiTool, RegisterAiKnowledge, etc.

• Rename UPDATE_USER_NOTIFICATION_SETTINGS_ERROR to UPDATE_NOTIFICATION_SETTINGS_ERROR when using useNotificationSettings or useUpdateNotificationSettings.

• Introduce pre-built components for AI Copilots: AiChat, AiTool, etc.

• The onMentionClick prop on Thread and Comment now receives a MentionData object instead of a userId string.

• The Mention component on the Comment.Body and Composer.Editor primitives now receives a mention prop instead of a userId one.

• The MentionSuggestions component on the Composer.Editor primitive now receives a mentions prop instead of a userIds one, and the selectedUserId prop has been renamed to selectedMentionId.

• Rename LiveblocksUIConfig to LiveblocksUiConfig for consistency with other Liveblocks APIs.

• Remove deprecated htmlBody/reactBody properties from prepareThreadNotificationEmailAsHtml/prepareThreadNotificationEmailAsReact, use body instead.

• Remove htmlContent/reactContent properties from prepareTextMentionNotificationEmailAsHtml/prepareTextMentionNotificationEmailAsReact, use content instead.

• The prepareTextMentionNotificationEmailAsReact and prepareTextMentionNotificationEmailAsHtml functions’ returned data changed slightly:

  • The id property is now named textMentionId, it refers to the mention’s Text Mention ID, not the user ID used for the mention
  • The id property now refers to the mention’s ID, as in the user ID used for the mention

• The element prop received by the Mention component in prepareTextMentionNotificationEmailAsReact now contains an id property instead of userId, and a new kind property to indicate the mention’s kind.

• The getMentionedIdsFromCommentBody utility has been replaced by getMentionsFromCommentBody.

Dashboard

• Introduce an AI Copilots view to manage copilots and their knowledge.

Examples

• New example: AI Popup Chat.
• New example: AI Chats.
• New example: AI Reports Dashboard.

Website

• New blog post: Meet Liveblocks 3.0, the fastest way to let people collaborate with AI in your product.

Contributors

Contributors include:

11 authors

• Fix an issue with subpath imports (e.g. @liveblocks/react/suspense) and CommonJS which could happen with certain bundlers.

Contributors

Contributors include:

1 authors

• Disable or hide actions in Thread and Comment components for users without permission to perform them, such as adding reactions or (un)resolving threads.

Contributors

Contributors include:

1 authors

v2.24.1

• Fix for occasional desync issue.

v2.24.0

We are introducing thread subscriptions to add more granularity to thread notifications, allowing users to subscribe to threads without participating or unsubscribing from specific ones.

We are also using this opportunity to rename some of the concepts around notifications and notification settings to improve clarity. None of these changes are breaking but you can learn more about them, their rationale, and how to automatically apply them with a codemod in our Upgrade Guide for 2.24.

• Add "Subscribe to thread" and "Unsubscribe from thread" actions to Thread and thread InboxNotification out of the box.

• Add useSubscribeToThread and useUnsubscribeFromThread hooks.

• Add subscribe and unsubscribe methods to the existing useThreadSubscription hook.

• Add support for textMentions in room subscription settings.

• Rename useRoomNotificationSettings and useUpdateRoomNotificationSettings to useRoomSubscriptionSettings and useUpdateRoomSubscriptionSettings.

• Add subscribeToThread, unsubscribeFromThread, getThreadSubscriptions and getUserRoomSubscriptionSettings methods.

• Add support for textMentions in room subscription settings.

• Rename getRoomNotificationSettings, updateRoomNotificationSettings, and deleteRoomNotificationSettings to getRoomSubscriptionSettings, updateRoomSubscriptionSettings, and deleteRoomSubscriptionSettings.

• Add Room.subscribeToThread and Room.unsubscribeFromThread methods.

• Methods which return threads and their associated inbox notifications now also return the thread’s associated subscriptions.

• Add support for textMentions in room subscription settings.

• Rename Room.getNotificationSettings and Room.updateNotificationSettings to Room.getSubscriptionSettings and Room.updateSubscriptionSettings.

MCP server

• New MCP server has been created for Liveblocks.
• Create and modify rooms, threads, comments, notifications, more.
• Read realtime Storage and Yjs values.
• Broadcast custom events to connected clients.
• Mark threads and notifications as read/unread.

Documentation

• New page detailing how to use the Liveblocks MCP server.

Website

• New trust center has been created, and links added to our website.

Contributors

Contributors include:

4 authors

v2.23.2

• Add closeAi Tiptap command to manually close the AI toolbar.

• Fix AiToolbar focus behavior in Safari.

• Fix FloatingToolbar focus behavior in Safari.

• Fix FloatingToolbar focus behavior in Safari.

v2.23.1

• Fix potential runtime error in browsers that do not support Symbol.dispose yet.

• Fix a bug in .mutateStorage() and .massMutateStorage() where mutating storage could potentially corrupt the storage tree.

v2.23.0

• Expose new property triggeredAt for notification webhook events.

• The prepareThreadNotificationEmailAsHtml and prepareThreadNotificationEmailAsReact functions are now avoiding duplicated comments between two emails data.

• Improve event propagation from Composer and the emoji pickers in Comment/Thread.

• Fix crash when unmounting. Thank you @nperez0111!

• Fix withLiveblocksEditorOptions not passing all options to BlockNote. Thank you @chadnorvell!

Documentation

• New AI Copilots features page, highlighting all upcoming features.
• Mention first day free policy.
• Small updates to docs homepage

Dashboard

• Refined billing and usage settings page, now displaying billed and non-billed users for monthly active users (MAUs) metric.

Website

• New blog post: Add Notion-style collaborative text editing to your app with Liveblocks BlockNote.
• New blog post: Introducing fairer billing with first day free.
• New blog post: Rethinking product strategy in the age of AI with Melissa Perri.
• New blog post: What’s new in Liveblocks: March 2025.
• New blog post: How Artefect reinvented collaborative workspaces for technical teams.

Contributors

Contributors include:

8 authors

v2.22.3

• The InboxNotification component now uses resolveRoomsInfo for textMention notifications to make them link to the mentions’ room automatically if href isn’t set.

• Fix names capitalization in lists. (e.g. the list of who reacted in reactions’ tooltips)

• Add emojibaseUrl advanced option on LiveblocksUIConfig to allow choosing where Emojibase’s data used by the Liveblocks emoji picker is fetched from: another CDN, self-hosted files, etc.

• Fix: Update dependencies resolution.

• Fix: Avoid <AnchoredThreads /> threads rendering if the editor's view is null.

Contributors

Contributors include:

2 authors

v2.22.2

• Optimize .getOrCreateRoom() to only make a single round-trip to the server.
• Optimize .upsertRoom() to only make a single round-trip to the server.
• Also expose LiveObject, LiveMap, and LiveList in @liveblocks/node.

v2.22.1

• Fix report text editor function's call. Now we report correctly blocknote as text editor type.

• Internal refactoring.

• Fix: improve stack traces of REST API errors to include the original error location.

Dashboard

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

Documentation

• Improve guide on how to modify Liveblocks Storage from the server.
• Fix BlockNote code snippets and add info about it in the email package.

Examples

• Improve notification settings in the Next.js Starter Kit.
• Update notifications settings example to use the latest APIs.

Contributors

Contributors include:

4 authors

v2.22.0

• Added pagination support to .getInboxNotifications(). See docs.

• New method .getOrCreate() which combines .getRoom() and .createRoom(). See docs.

• New method .upsertRoom() which combines .updateRoom() and .createRoom(). See docs.

• New method .iterRooms() which is like .getRooms() except pagination happens automatically. See docs.

• New method .iterInboxNotifications() which is like .getInboxNotifications() except pagination happens automatically. See docs.

• New method .mutateStorage() which can be used to make changes to Storage from your backend. See docs.

• New method .massMutateStorage() which can be used to make changes to Storage for multiple rooms simultaneously. See docs.

• Updated method .deleteRoom() to no longer throw when the room already does not exist. See docs.

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

• Implement a new core logic for thread notification event.

• Mark htmlBody from prepareThreadNotificationEmailAsHtml and reactBody from prepareThreadNotificationEmailAsReact as deprecated. Use body property instead.

v2.21.0

• New package to support using BlockNote with Liveblock’s comments, mentions, and realtime collaboration out of the box.

• Fix markThreadAsResolved and markThreadAsUnresolved methods not passing user ID correctly to the corresponding backend endpoints.

• Improve emoji picker’s performance, bundle size, and add a preview of the currently selected emoji.

  • This is the result of us moving the emoji picker to its own package and improving it in the process. You can also combine this package with the primitives to build your own reaction picker for example.

• Improve and fix pasting HTML into the composer.

REST API

• The Delete Room endpoint will no longer return a 404 when a room already did not exist before.

Examples

• Updated Comments primitives example to use Frimousse.
• Updated BlockNote example to use our new package.

Documentation

• Mention our latest package, Frimousse.
• Detail building a primitive emoji picker and emoji reactions.
• API reference for all new Node.js methods.
• API reference for @liveblocks/react-blocknoite.
• Updated get started guides for BlockNote.
• New BlockNote overview page.
• Updated guide on modifying Storage from the server.

Website

• New blog post: We’ve open-sourced our customizable React emoji picker.

Contributors

Contributors include:

7 authors

Documentation

• Fixed a bug in the interactive React tutorial and updated all demos to use Vite instead of Create React App.
• Improved guide on How to modify Liveblocks Storage from the server.
• Add more info about text editor data being permanently stored.

Website

• New blog post: How to build notifications that encourage collaboration.
• New blog post: What’s new in Liveblocks: February 2025.

Contributors

Contributors include:

3 authors