> ## Documentation Index
> Fetch the complete documentation index at: https://velt-v6-0-0-beta-4.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Velt SDK Changelog

> Release Notes of changes added to the core Velt SDK

### Libraries

* `@veltdev/react`
* `@veltdev/client`
* `@veltdev/sdk`
* `@veltdev/types`

<Update label="6.0.0-beta.4" description="July 02, 2026">
  This release brings the Comment Sidebar V2 to parity with V1 across grouping, filtering, and counting.

  ### Improvements

  * \[**Comments**]: When grouped by location or document, the V2 sidebar now starts with only the current group expanded; explicit expand/collapse choices persist across reloads. [Learn more →](/async-collaboration/comments-sidebar/v2/customize-behavior#groupconfig)

  * \[**Comments**]: The Status filter now starts with Open and In Progress statuses pre-selected on first load, matching V1's `setDefaultStatuses`. [Learn more →](/async-collaboration/comments-sidebar/v2/customize-behavior#default-status-selection)

  * \[**Comments**]: [`setCommentSidebarFilters()`](/api-reference/sdk/api/api-methods#setcommentsidebarfilters) now renders client filters as checked options in the filter panel, cleared by Reset. [Learn more →](/async-collaboration/comments-sidebar/v2/customize-behavior#setcommentsidebarfilters)

  ### Bug Fixes

  * \[**Comments**]: Name-only locations (`setLocation({ locationName: 'Home' })`) now scope sidebar grouping, filtering, page mode, and client filters.

  * \[**Comments**]: People, Involved, Assigned, and Tagged filter options are now keyed by `userId`, so a person referenced by both `userId` and email no longer appears as two options.

  * \[**Comments**]: With `setSidebarButtonCountType('filter')`, the sidebar-button badge now counts the actual filtered list, and the same list gates on-page pins when `filterCommentsOnDom` is enabled. [Learn more →](/async-collaboration/comments-sidebar/v2/customize-behavior#sidebarbuttoncounttype)

  * \[**Comments**]: Selecting "All" on the Status field or hitting Reset now reveals resolved comments, matching V1.

  * \[**Comments**]: The default Priority section now shows a "Not set" bucket for comments with no priority, matching V1.

  * \[**Comments**]: Client filters set via `setCommentSidebarFilters()` for fields not shown in the Main Filter panel (e.g. `version`) now filter the list.

  * \[**Comments**]: The cross-field `system-filters-operator` (AND/OR) is now applied to the sidebar filter engine, including values set before initialization.

  * \[**Comments**]: The V2 sidebar virtual-scroll list now clips wide rows instead of scrolling horizontally, matching V1's layout.
</Update>

<Update label="6.0.0-beta.3" description="June 30, 2026">
  ### New Features

  * \[**Comments**]: New `restrictTextSearchToAnchor` prop and `enableRestrictTextSearchToAnchor()` / `disableRestrictTextSearchToAnchor()` methods to restrict a text comment's highlight search to its original anchor element, with no wider fallback. [Learn more →](/async-collaboration/comments/customize-behavior)

  ### Improvements

  * \[**Self-Hosting**]: The `fieldsToRemove` allowlist now applies to reaction annotations, recorder annotations, and all activity feature types (previously only comments and `custom` activities). [Learn more →](/self-host-data/overview#excluding--extending-fields)

  * \[**Comments**]: Explicitly selecting "Resolved" (or any terminal status) in the V2 sidebar status filter now surfaces those comments instead of hiding them by default. [Learn more →](/async-collaboration/comments-sidebar/v2/customize-behavior)

  ### Bug Fixes

  * \[**Comments**]: Text comments whose anchor text went stale now re-highlight via a wider fallback search instead of silently ghosting. [Learn more →](/async-collaboration/comments/customize-behavior)

  * \[**Comments**]: V2 sidebar facet counts are now computed against the same boundaries as the visible list, so a non-zero count no longer filters the list to nothing when selected. [Learn more →](/async-collaboration/comments-sidebar/v2/customize-behavior)

  * \[**Types**]: The `@veltdev/types` published entry chain is now type-only, so type-only symbols can no longer be accidentally imported as runtime values that resolve to `undefined`.

  * \[**Types**]: Published element-model declarations are re-synced with the runtime SDK — corrected return types, removed stale aliases, and added missing Presence, Notification, Rewriter, and Recorder method declarations.
</Update>

<Update label="6.0.0-beta.2" description="June 24, 2026">
  V2 comment sidebar events now flow through the unified `commentElement.on()` event bus, plus correctness fixes for comments, reactions, and notifications.

  ### New Features

  * \[**Comments**]: Four new comment events on the `on()` bus — `sidebarOpen`, `sidebarClose`, `commentClick`, and `commentNavigationButtonClick`. Subscribe via `commentElement.on(...)` or `useCommentEventCallback(...)`. [Learn more →](/async-collaboration/comments/customize-behavior)

  ### Improvements

  * \[**Comments**]: V2 sidebar filter option counts are now absolute — they no longer shift as you apply search text or other filters. [Learn more →](/async-collaboration/comments-sidebar/v2/customize-behavior)

  * \[**Comments**]: Visual fixes to the V2 sidebar filter dropdown — dark-mode icon color, checkbox alignment, and selected-row accent color. [Learn more →](/async-collaboration/comments-sidebar/v2/customize-behavior)

  ### Bug Fixes

  * \[**Comments**]: Recipients granted via `enablePrivateMode({ type: 'restricted', userIds: [...] })` are no longer dropped when a new pin is submitted.

  * \[**Comments**]: The reaction pin and reaction tool render correctly again inside the comment dialog thread card.

  * \[**Comments**]: The default-mode V2 comment sidebar no longer reserves an invisible full-height block at its tag location.

  * \[**Notifications**]: Custom notification data now resolves correctly for self-hosted data providers when document paths don't carry an organization id.
</Update>

<Update label="6.0.0-beta.1" description="June 23, 2026">
  First beta of the modular SDK. The public `Velt` browser API is fully backward compatible — existing browser integrations work unchanged.

  ### New Features

  * \[**Core**]: **Modular SDK** — each feature now loads as its own on-demand chunk. Pass `featureAllowList` at init (e.g. `['comment', 'presence']`) to preload only the features you use; omit it to keep the existing behavior of preloading everything. [Learn more →](/api-reference/sdk/models/data-models)

  * \[**Core**]: New `preload<Feature>()` methods (e.g. `preloadComment()`) to warm a feature chunk ahead of use, or to load tag-only features (`userInvite`, `userRequest`, `videoPlayer`). [Learn more →](/api-reference/sdk/api/api-methods)
</Update>