Libraries
@veltdev/react@veltdev/client@veltdev/sdk
New Features
- [Comments]: Added page mode composer context APIs to pass context when opening the sidebar via the comment tool. When enabled, clicking the comment tool opens the sidebar with the page mode composer and passes configured context automatically.
- React / Next.js
- Other Frameworks
- [Comments]: Added
setAssignToType()method to switch the assignment UI between dropdown and checkbox modes. Checkbox mode allows quick self-assignment with a toggle.
- React / Next.js
- Other Frameworks
- [Comments]: Added “Assigned to me” filter option in the sidebar to filter comments by assignment.
- React / Next.js
- Other Frameworks
- [Comments]: Added new event types to track comment tool and sidebar button clicks. Subscribe to these events to access context data for analytics and custom workflows.
- React / Next.js
- Other Frameworks
- [Comments]: Added
readOnlyprop to control read-only mode at the component level. The local prop takes precedence over global settings when explicitly set.
- React / Next.js
- Other Frameworks
- [Comments]: Added wireframe component to customize the assign button on thread cards.
- React / Next.js
- Other Frameworks
- [Comments]: Added wireframe component to customize the edit composer within comment thread cards.
- React / Next.js
- Other Frameworks
- [Comments]: Added reaction pin component to pin specific reactions and exclude them from the general list.
- React / Next.js
- Other Frameworks
- [Comments]: Added
resolvedByUserproperty onCommentAnnotationto access the full user object of who resolved a comment.
Improvements
- [Comments]: Renamed
targetElementIdtotargetComposerElementIdonVeltCommentComposerfor clarity.
- React / Next.js
- Other Frameworks
- [Comments]: Added CSS class
.velt-assign-dropdown--checkbox-icon-selectedto style the checkbox selected state.
Bug Fixes
- [Comments]: Fixed cursor jumping when clicking autocomplete tool buttons. Text now inserts at the correct cursor position.
- [Comments]: Fixed actions menu visibility so it remains visible when the assignment dropdown is opened.
- [Comments]: Added “Assign” tooltip to the assignment button in thread cards.
- [Comments]: Fixed “Assign To” label capitalization to “Assign to”.
- [Reactions]: Added
.velt-reaction-pin--no-reactionsCSS class for styling empty reaction pins. - [Comments]: Fixed autocomplete panel viewport height to respect custom
itemSizefromautoCompleteScrollConfig. - [Comments]: Fixed attachment metadata handling to use fallback values when metadata is unavailable.
- [Comments]: Fixed read-only state management so local
readOnlyprops are not overridden by global state changes. - [Reactions]: Fixed reactions panel to return an empty array on error instead of default emojis.
- [Comments]: Fixed
reactionIdprop onVeltCommentDialogWireframe.ThreadCard.ReactionPinto properly convert to dashed-case in React.
New Features
- [Notifications]: Added ability to enable organization-level notification settings. This allows you to configure notifications once for all documents in an organization instead of per document.
- React / Next.js
- Other Frameworks
Improvements
- [Comments]: Comments sidebar group-by views now display “Unassigned” for annotations without assignees and “Untagged” for annotations without tagged users.
Bug Fixes
- [Comments]: Fixed an issue where image attachments in comment dialog were not opening in a lightbox view.
-
[Comments]: Fixed an issue where sometimes user mentions did not include the leading
@symbol in display text. - [Comments]: Fixed an issue where the recorder control panel in comment dialog composer did not appear when a valid comment dialog ID was not present in component configuration.
- [Comments]: Fixed an issue where assignment and private comment options did not respect explicit configuration in sidebar mode.
-
[Comments]: Fixed an issue where the comment dialog internal tag was changed from
snippyly-comment-dialogtovelt-comment-dialog-internalfor correct sidebar focus and keyboard behavior.
Improvements
- [Comments]: Added ability to enable/disable Private Comments feature in Velt Console
Improvements
- [Comments]: Added
batchedPerDocumentmode forgetCommentAnnotationsCount()that makes the query more efficient by up to 80% while maintaining per-document granularity. Very useful for UIs that need to display comment counts for 100 documents or less on the same page.
- React / Next.js
- Other Frameworks
Bug Fixes
- [Comments]: Fixed draft mode not working properly. Draft content is now preserved when the dialog is closed and the shake animation now works as expected.
-
[Comments]: Fixed context property access in
velt-dataelements. Templates can now access context properties using{context.propertyName}patterns. - [Comments]: Fixed edit mode state persisting after dialog close. Reopening the dialog now shows the normal view instead of the edit composer.
- [Comments]: Fixed text reappearing when using select-all-and-delete in edit mode composer. Users can now properly delete all text in edit mode.
- [Comments]: Fixed links in comment body not clickable. Clicking links in comment text now opens them in a new tab.
- [Comments]: Fixed paste handling. Pasting a URL over selected text creates a hyperlink, multiline text preserves line breaks, and images paste as attachments.
- [Comments]: Fixed ghost comment banners not displaying. “Comment is syncing…” messages now properly show while annotation data is loading.
- [Comments]: Fixed priority selection not working on new annotations. Users can now set priority before submitting the first comment.
-
[Comments]: Fixed email detection after @ symbol. Typing
@user@example.comand pressing space now creates an email mention. - [Comments]: Fixed recording in progress flag not clearing. Dialog now properly closes on click outside after recording finishes.
- [Comments]: Fixed links and @here mentions not highlighted in comment text. URLs are now styled as clickable links and @here mentions are properly highlighted.
New Features
- [Comments]: Introducing Private Comments feature: Added
updateVisibility()method to programmatically set comment access (public, organization, or private). Learn more
- React / Next.js
- Other Frameworks
Bug Fixes
- [Comments]: Fixed mentioned users not receiving notifications. Users @mentioned in comments now correctly receive notifications.
- [Comments]: Fixed notification action type validation. Clients only receive data for valid event types.
- [Comments]: Fixed status reset when deleting comments. Status now only resets when current status is terminal.
New Features
- [Comments]: Added
addCommentAnnotationDraftevent to dynamically set context when creating comment annotations. Triggered beforeaddCommentAnnotationevent clicks on the comment tool and the composer is rendered.
- React / Next.js
- Other Frameworks
Improvements
- [Comments]: Added
setContextProvidermethod to set a global context provider for all comment annotations. Also addeduseSetContextProviderhook for React applications.
- React / Next.js
- Other Frameworks
Bug Fixes
- [Comments]: Fixed page mode and multi-thread annotation ID not found error. Page mode and multi-thread comments now work as expected.
-
[Comments]: Fixed
updateOverlayPositionfunction not triggering. Comment dialog now opens in the correct position. - [Comments]: Fixed unread status issues in inline and focused thread modes. Annotations are now marked as read when opened or clicked.
- [Comments]: Fixed three-dot menu not visible in sidebar.
- [Comments]: Fixed composer not being focused when opened.
- [Comments]: Fixed comments navigating on click. Comments now only navigate when the navigation button is clicked.
Bug Fixes
- [Comments]: Fixed
lastUpdatedtimestamp not being updated when changing context in comment annotation via SDK. Ensures context updates are properly synced to other users.
Improvements
- [Core]: Added robustness to initialization when
VeltProviderwas re-rendered multiple times over a slow network.
Bug Fixes
-
[Comments]: Refactored
submitCommentmethod to fix resolver issue forvelt-comment-composer. Now follows the standard comment submission flow. - [Comments]: Fixed unread status not updating correctly in bottom sheet. This was a regression in v5.
- [Comments]: Fixed navigation button not working properly. This was a regression in v5.
-
[Comments]: Fixed disable recording option not working in
velt-comment-composer. This was a regression in v5.
New Features
- [Core]: Added
globalStylesoption to control whether Velt’s global CSS is loaded. Set tofalseto disable default styles when implementing custom theming.
- React / Next.js
- Other Frameworks
- [Comments]: Added
submitComment(targetElementId)method to programmatically trigger comment submission. Enables custom buttons or keyboard shortcuts for submitting comments.
- React / Next.js
- Other Frameworks
- [Comments]: Added
placeholderprop to customize input placeholder text in comment composer. Overrides default placeholders. Learn more
- React / Next.js
- Other Frameworks
- [Comments]: Added
composerTextChangeevent that fires when text changes in any comment composer. Enables features like auto-save drafts, character counters, or real-time validation. Learn more
- React / Next.js
- Other Frameworks
Bug Fixes
Comment Dialog Primitives
Released 115+ primitive components for building custom comment dialogs. Each subcomponent can now be used independently without requiring the full dialog structure.- React / Next.js
- Other Frameworks
- Header/Body: Header, Body, CloseButton
- Thread: ThreadCard with Avatar, Name, Time, Message, Reactions, Recordings, Reply, Options, and more
- Composer: Composer, ComposerInput, ComposerActionButton, ComposerAttachmentButton, ComposerRecorderButton, ComposerRecorderPlayer, ComposerFiles
- Dropdowns: StatusDropdown, PriorityDropdown, OptionsDropdown, CustomAnnotationDropdown (each with full sub-component breakdown)
- Additional: ReplyAvatars, AssigneeBanner, ResolveButton, UnresolveButton, CopyLink, DeleteButton, PrivateBanner, NavigationButton, and 90+ more

