Changelog

• Changed name of Liveblocks-sent notifications (thread, textMention) from Liveblocks notifications to Collaboration notifications.

• New blog post: Building an AI copilot inside your Tiptap text editor.

Contributors

Contributors include:

2 authors

v3.10.1

• Fix a bug where a fresh provider is required by Lexical in order to initialize properly by always requieting a new provider in the factory function

Documentation

• New section on group mentions.
• Updated other information on the users and mentions page.
• Updated Tenants page with new information.
• Add information on AI web search in overview pages.

Dashboard

• Standardized all date displays with a new unified component, including richer hover details, copyable timestamps, and improved list-view scannability.

Website

• New blog post: What's new in Liveblocks: October 2025.
• New streaming video player in blog posts.
  • Smoother, as quality is automatically adjusted to stream without pauses on poor connections.
  • More performant, as offscreen videos automatically pause.
  • More accessible, as videos are paused by default for those with prefers-reduced-motion: reduce enabled.

Contributors

Contributors include:

4 authors

v3.10.0

• Tweak reconnection logic to not retry on specific 400 level error codes.

• Prevents certain 400 level errors from being reported as a 403.

• Add dropdownItems prop to Comment (commentDropdownItems prop on Thread) to allow customizing comments’ dropdown items in the default components.

• Fix scroll issues in some scenarios where AiChat would be rendered but hidden.

• Support for Tiptap v3.

Documentation

• New guide: Upgrading to 3.10.
• New guide: Migrating from Tiptap 2 to 3.
• New guide: Tiptap best practices and tips.
• New guide: Yjs best practices and tips.

Contributors

Contributors include:

4 authors

v3.9.1

• Update type definitions for provider models to support GPT-5 variants.

Documentation

• New AI Copilots get started guides for Next.js and React.
• New AI Copilots overview pages:
  • Copilots.
  • Default components.
  • Hooks.
  • Knowledge.
  • Tools.
  • Styling and customization.
  • Troubleshooting.
• New guide: How to use fallback AI models in AI Copilots.

Examples

• Added batched notifications to Custom Notifications example.

Website

• New diff code block styling.
• New icons for docs overview pages.
• Fixed example integrations when no environment variable is needed.
• Fixed code snippet background color.

Contributors

Contributors include:

2 authors

v3.9.0

• Add support for web search to <AiChat /> component.

• Add showSources, showRetrievals and showReasoning props to <AiChat /> component to determine how sources, retrievals and reasoning are displayed respectively.

• Disable AI chat composers when AI service is not available.

• Add query filter subscribed on the useThreads hook.

• Add useUrlMetadata hook to get metadata for a given URL.

• Expose disconnected status in useAiChatStatus to indicate when AI service is not available.

• Add query filter subscribed on the room.getThreads method.

• Update createAiCopilot and updateAiCopilot to include web search in provider options for OpenAI and Anthropic.

• Remove all schema validation related client methods that should no longer be used. Schema validation was sunsetted on May 1st, 2025.

Dashboard

• Greatly improved “Notifications” flow, making it much clearer how they're linked to webhooks.
  • New “Kinds” tab, allowing you to define batching per kind.
  • See the status of your webhooks from here.
  • Warnings when no webhooks are set up, and shortcuts to get started.
• Improved “Webhooks” page.
  • Set a rate limit for your webhooks when creating them.
  • More detailed error messages when creating webhooks.
  • Better UX on the URL input.
• Improved UX when creating projects
  • New polished project cards displaying more info such as region restrictions.
  • More clarity in project creation dialog boxes.
• Improved team/project selectors with UI polish and better accessibility.
• Improved MAU usage cards showing your team’s personalized limits.
• More clarity in project settings regarding environment and regions not being editable.
• Fixed problem downloading examples with create-liveblocks-app integration.

Documentation

• New sections on notification batching.
• Better clarity on Storage/Yjs limits.

Contributors

Contributors include:

8 authors

v3.8.1

• Add chatId prop to RegisterAiKnowledge to scope knowledge to a specific chat, similar to RegisterAiTool. This is the same as using the knowledge prop on AiChat.

• Fix issue where useAiChat() didn't re-render correctly when chat title gets updated.

• Fix issue where tenantId was not being passed to the request when using Liveblocks.createRoom().

• Add comments:write to the list of possible room permissions.

Examples

New example: AI app builder. New example: AI calendar.

Contributors

Contributors include:

6 authors

v3.8.0

• LiveMap and LiveObject deletions now report which item got deleted in the update notifications. LiveLists already did this.

• Support numerical operators gt, lt, gte, and lte in room.getThreads metadata query filters.

• Add new hook useAiChatStatus that offers a convenient way to get the current generation status for an AI chat, indicating whether the chat is idle, currently generating contents, and, if so, what type of content is currently generating.

• Fixes an issue where useUnreadInboxNotificationsCount wasn't returning the proper count if there were more than a page of unread notifications.

• Support numerical operators gt, lt, gte, and lte in useThreads metadata query filters.

• Add responseTimeout property to AiChat to allow customization of the default 30 seconds timeout.

• The title prop on AiTool now accepts ReactNode, not just strings.

• Fix a bug where AiChat would not always scroll in the same way when sending new messages.

• Add new method Liveblocks.prewarmRoom(roomId, options). This method can prewarm a room from your backend, preparing it for connectivity and making the eventual connection from the frontend faster.

Website

• Blog post: Why we built our AI agents on WebSockets instead of HTTP.

Contributors

Contributors include:

6 authors

Website

• Blog post: What's the best vector database for building AI products?.
• Blog post: What's new in Liveblocks: August 2025.

Contributors

Contributors include:

2 authors

v3.7.1

• Add query filters roomId and kind on the useUnreadInboxNotificationsCount hook.

v3.7.0

This release introduces group mentions (e.g. @engineering) across all packages and first-class support for tenants. Learn more about group mentions and tenants in the docs.

• Add new resolveGroupsInfo resolver to provide information about groups (e.g. name, avatar, etc) similar to resolveUsers.

• Support returning group mention suggestions in resolveMentionSuggestions.

• Support group mentions in stringifyCommentBody, it now accepts a resolveGroupsInfo option that passes the results to mentions as group.

• Add query filters roomId and kind on the getInboxNotifications method.

• Add useGroupInfo hook to use resolveGroupsInfo in React, same as useUser for resolveUsers.

• Add query filters roomId and kind on the useInboxNotifications hook.

• Support group mentions in default components (mentions suggestions dropdowns, Thread, Composer, InboxNotification, etc).

• Support group mentions in text editors and comments-related components.

• Support group mentions in text editors.

• Add methods to manage groups on Liveblocks (e.g. createGroup, getUserGroups).

• Add tenantId parameters to methods that need it when using tenants.

• Mark getThreadParticipants as deprecated, use thread subscriptions or getMentionsFromCommentBody instead.

• Support group mentions in stringifyCommentBody, it now accepts a resolveGroupsInfo option that passes the results to mentions as group.

• Support group mentions in email notifications helpers. These functions now accept a resolveGroupsInfo option that passes the results to mentions as group.

3.6.2

• Rename budgetToken to budgetTokens in AnthropicProviderOptions.

v3.6.1

• Fixes a bug where a specific combination of concurrent LiveList mutations could break eventual consistency (two clients disagreeing on the final document state).

• Only show retrieval and reasoning durations in AiChat when they are 3 seconds or longer.

• Make AiTool titles selectable.

Website

• AI assistant has been added to the documentation and dashboard pages. It can answer questions on anything related to Liveblocks, such as code, recommendations, bugs, billing, usage, and project information. It's powered by AiChat.

Contributors

Contributors include:

7 authors

v3.6.0

• Auto-abort this client's tool calls on page unload to prevent hanging chats.

• Reasoning in AiChat now displays how long it took.

• AiChat nows shows when a copilot is searching its knowledge defined on the dashboard, as a "Searching 'What is RAG?'…" indicator. It also displays how long it took.

• Add Duration primitive to display formatted durations, similar to the existing Timestamp primitive.

• Better type safety for copilot creation and update options.

• Add missing type export for AI Copilot and knowledge sources.

v3.5.4

• Throttle incoming AI delta updates to prevent excessive re-renders during fast streaming.

• Optimized partial JSON parser for improved tool invocation streaming performance.

• Fixes a bug where the a comment could not be selected if it was within a previously deleted comment.

Dashboard

• Add API reference modal to AI Copilot detail pages, with React, Node.js, and REST API snippets to get started quickly.

Contributors

Contributors include:

5 authors