We recommend that you familiarize yourselves with UI Customization Concepts before attempting to modify any components.
Overview
The Comment Dialog Primitives API provides 94+ granular components that can be used independently to build completely custom comment interfaces. Each primitive can be used standalone or composed together for maximum customization flexibility.Usage Patterns
Pattern 1: Context Wrapper (Recommended)
Components are wrapped in a context wrapper that provides shared context to children.- React / Next.js
- Other Frameworks
Pattern 2: ID-Based (Standalone)
Each component receivesannotationId directly and works independently.
- React / Next.js
- Other Frameworks
Common Inputs
All components inherit these base inputs. SeeCommentDialogCommonProps for the type definition.
Components
VeltCommentDialogContextWrapper
Context wrapper that provides shared annotation context to child primitives. Props:CommentDialogContextWrapperProps
- React / Next.js
- Other Frameworks
VeltCommentDialogHeader
Header component for the comment dialog.- React / Next.js
- Other Frameworks
VeltCommentDialogBody
Body container for the comment dialog thread content.- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCard
Complete thread card with all comment metadata and content. SeeThreadCardProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardAvatar
User avatar for the comment author. SeeCommentIndexProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardName
Display name of the comment author. SeeCommentIndexProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardTime
Timestamp of when the comment was created. SeeCommentIndexProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardMessage
The comment message content. SeeCommentIndexProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardMessageShowMore
Show-more toggle that appears when message truncation is enabled and the message exceeds the configured line limit; clicking expands the full message.- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardMessageShowLess
Show-less toggle that collapses an expanded truncated message back to the truncated state.- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardReactions
Reactions display for the comment. SeeCommentIndexProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardReactionTool
Tool for adding reactions to a comment. SeeCommentIndexProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardRecordings
Recordings attached to the comment. SeeCommentIndexProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardReply
Reply indicator for the thread card.- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardUnread
Unread indicator for the comment. SeeCommentIndexProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardEdited
Edited indicator for the comment. SeeCommentIndexProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardDraft
Draft indicator for the comment. SeeCommentIndexProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardDeviceType
Device type indicator for the comment. SeeCommentIndexProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogThreadCardOptions
Options menu for the comment (edit, delete, etc.). SeeCommentIndexProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogComposer
Complete composer with input, attachments, and action buttons. SeeComposerProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogComposerInput
Text input field for composing comments. SeeComposerInputProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogComposerActionButton
Submit/send button for the composer.- React / Next.js
- Other Frameworks
VeltCommentDialogComposerAttachmentButton
Button to add file attachments to comments.- React / Next.js
- Other Frameworks
VeltCommentDialogComposerRecorderButton
Button to add audio/video recordings.- React / Next.js
- Other Frameworks
VeltCommentDialogComposerRecorderPlayer
Player for audio/video recordings in the composer.- React / Next.js
- Other Frameworks
VeltCommentDialogComposerFiles
Files display in the composer.- React / Next.js
- Other Frameworks
VeltCommentDialogComposerAttachmentsImageDownload
Download button for image attachments in the comment dialog composer when in edit mode.- React / Next.js
- Other Frameworks
VeltCommentDialogComposerAttachmentsOtherDownload
Download button for non-image file attachments in the comment dialog composer when in edit mode.- React / Next.js
- Other Frameworks
VeltCommentDialogStatusDropdown
Complete status dropdown with trigger and content.- React / Next.js
- Other Frameworks
VeltCommentDialogStatusDropdownTrigger
Button that opens the status dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogStatusDropdownTriggerIcon
Icon for the status dropdown trigger.- React / Next.js
- Other Frameworks
VeltCommentDialogStatusDropdownTriggerName
Name display for the status dropdown trigger.- React / Next.js
- Other Frameworks
VeltCommentDialogStatusDropdownTriggerArrow
Arrow indicator for the status dropdown trigger.- React / Next.js
- Other Frameworks
VeltCommentDialogStatusDropdownContent
Dropdown content container for status options.- React / Next.js
- Other Frameworks
VeltCommentDialogStatusDropdownContentItem
Individual status item in the dropdown. SeeStatusDropdownItemProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogStatusDropdownContentItemIcon
Icon for a status dropdown item.- React / Next.js
- Other Frameworks
VeltCommentDialogStatusDropdownContentItemName
Name display for a status dropdown item.- React / Next.js
- Other Frameworks
VeltCommentDialogPriorityDropdown
Complete priority dropdown with trigger and content.- React / Next.js
- Other Frameworks
VeltCommentDialogPriorityDropdownTrigger
Button that opens the priority dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogPriorityDropdownTriggerIcon
Icon for the priority dropdown trigger.- React / Next.js
- Other Frameworks
VeltCommentDialogPriorityDropdownTriggerName
Name display for the priority dropdown trigger.- React / Next.js
- Other Frameworks
VeltCommentDialogPriorityDropdownTriggerArrow
Arrow indicator for the priority dropdown trigger.- React / Next.js
- Other Frameworks
VeltCommentDialogPriorityDropdownContent
Dropdown content container for priority options.- React / Next.js
- Other Frameworks
VeltCommentDialogPriorityDropdownContentItem
Individual priority item in the dropdown. SeePriorityDropdownItemProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogPriorityDropdownContentItemIcon
Icon for a priority dropdown item.- React / Next.js
- Other Frameworks
VeltCommentDialogPriorityDropdownContentItemName
Name display for a priority dropdown item.- React / Next.js
- Other Frameworks
VeltCommentDialogPriorityDropdownContentItemTick
Tick/checkmark for a priority dropdown item.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdown
Options menu for actions like assignment, editing, and notifications. SeeOptionsDropdownProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownTrigger
Trigger button for the options dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContent
Content container for the options dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentAssign
Assign option in the options dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentEdit
Edit option in the options dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentDelete
Delete option in the options dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentDeleteComment
Delete comment option in the options dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentDeleteThread
Delete thread option in the options dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentMakePrivate
Make private option container in the options dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentMakePrivateEnable
Enable private mode option.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentMakePrivateDisable
Disable private mode option.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentNotification
Notification option container in the options dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentNotificationSubscribe
Subscribe to notifications option.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentNotificationUnsubscribe
Unsubscribe from notifications option.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentMarkAsRead
Mark as read option container in the options dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentMarkAsReadMarkRead
Mark as read action option.- React / Next.js
- Other Frameworks
VeltCommentDialogOptionsDropdownContentMarkAsReadMarkUnread
Mark as unread action option.- React / Next.js
- Other Frameworks
VeltCommentDialogCustomAnnotationDropdown
Custom annotation dropdown component.- React / Next.js
- Other Frameworks
VeltCommentDialogCustomAnnotationDropdownTrigger
Trigger button for the custom annotation dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogCustomAnnotationDropdownTriggerArrow
Arrow indicator for the custom annotation dropdown trigger.- React / Next.js
- Other Frameworks
VeltCommentDialogCustomAnnotationDropdownTriggerList
List container for the custom annotation dropdown trigger.- React / Next.js
- Other Frameworks
VeltCommentDialogCustomAnnotationDropdownTriggerListItem
Individual item in the custom annotation dropdown trigger list. SeeCustomAnnotationItemProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogCustomAnnotationDropdownTriggerPlaceholder
Placeholder for the custom annotation dropdown trigger.- React / Next.js
- Other Frameworks
VeltCommentDialogCustomAnnotationDropdownTriggerRemainingCount
Remaining count indicator for the custom annotation dropdown trigger.- React / Next.js
- Other Frameworks
VeltCommentDialogCustomAnnotationDropdownContent
Content container for the custom annotation dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogCustomAnnotationDropdownContentItem
Individual item in the custom annotation dropdown content. SeeCustomAnnotationItemProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogCustomAnnotationDropdownContentItemIcon
Icon for a custom annotation dropdown item.- React / Next.js
- Other Frameworks
VeltCommentDialogCustomAnnotationDropdownContentItemLabel
Label for a custom annotation dropdown item.- React / Next.js
- Other Frameworks
VeltCommentDialogReplyAvatars
Container for reply avatars.- React / Next.js
- Other Frameworks
VeltCommentDialogReplyAvatarsList
List container for reply avatars.- React / Next.js
- Other Frameworks
VeltCommentDialogReplyAvatarsListItem
Individual avatar item in the reply avatars list. SeeReplyAvatarsListItemProps.
- React / Next.js
- Other Frameworks
VeltCommentDialogReplyCount
Reply count display.- React / Next.js
- Other Frameworks
VeltCommentDialogAssigneeBanner
Assignee banner container.- React / Next.js
- Other Frameworks
VeltCommentDialogAssigneeBannerResolved
Resolved state of the assignee banner.- React / Next.js
- Other Frameworks
VeltCommentDialogAssigneeBannerUnresolved
Unresolved state of the assignee banner.- React / Next.js
- Other Frameworks
VeltCommentDialogAssigneeBannerUnresolveButton
Button to unresolve the assignee banner.- React / Next.js
- Other Frameworks
VeltAutocomplete
The autocomplete panel component accepts the following props for controlling selection mode, ordering, and data source.- React / Next.js
- Other Frameworks
VeltAutocompleteEmptyWireframe
Customize the empty state shown when the autocomplete panel has no results. This is a wireframe component — for more wireframe customization patterns, see the Comment Dialog wireframes page.- React / Next.js
- Other Frameworks
VeltAutocompleteChip
Standalone autocomplete chip component for rendering selected contact chips.- React / Next.js
- Other Frameworks
VeltAutocompleteOption
Standalone autocomplete option component for rendering contact/custom options.- React / Next.js
- Other Frameworks
VeltAutocompleteOptionDescription
Standalone autocomplete option description component.- React / Next.js
- Other Frameworks
VeltAutocompleteOptionIcon
Icon for an autocomplete option.- React / Next.js
- Other Frameworks
VeltAutocompleteOptionName
Name display for an autocomplete option.- React / Next.js
- Other Frameworks
VeltAutocompleteOptionErrorIcon
Error icon for an autocomplete option.- React / Next.js
- Other Frameworks
VeltAutocompleteGroupOption
Group option in the autocomplete panel.- React / Next.js
- Other Frameworks
VeltAutocompleteTool
Tool component for the autocomplete panel.- React / Next.js
- Other Frameworks
VeltAutocompleteEmpty
Empty state for the autocomplete panel.- React / Next.js
- Other Frameworks
VeltAutocompleteChipTooltip
Tooltip for an autocomplete chip.- React / Next.js
- Other Frameworks
VeltAutocompleteChipTooltipIcon
Icon within the autocomplete chip tooltip.- React / Next.js
- Other Frameworks
VeltAutocompleteChipTooltipName
Name display within the autocomplete chip tooltip.- React / Next.js
- Other Frameworks
VeltAutocompleteChipTooltipDescription
Description within the autocomplete chip tooltip.- React / Next.js
- Other Frameworks
VeltCommentDialogResolveButton
Button to resolve a comment thread.- React / Next.js
- Other Frameworks
VeltCommentDialogUnresolveButton
Button to unresolve a comment thread.- React / Next.js
- Other Frameworks
VeltCommentDialogCopyLink
Button to copy the comment link to clipboard.- React / Next.js
- Other Frameworks
VeltCommentDialogCloseButton
Button to close the comment dialog.- React / Next.js
- Other Frameworks
VeltCommentDialogDeleteButton
Button to delete a comment.- React / Next.js
- Other Frameworks
VeltCommentDialogPrivateBanner
Banner indicating a comment’s private status.- React / Next.js
- Other Frameworks
VeltCommentDialogPrivateButton
Button to toggle private mode on a comment.- React / Next.js
- Other Frameworks
VeltCommentDialogGhostBanner
Banner displayed for ghost or anonymous comments.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBanner
Banner displaying the current visibility setting for a comment.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerIcon
Icon within the visibility banner.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerText
Text label within the visibility banner.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdown
Dropdown for selecting visibility options within the banner.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownTrigger
Trigger element for the visibility dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownTriggerLabel
Label text within the visibility dropdown trigger.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownTriggerAvatarList
Avatar list within the visibility dropdown trigger showing selected users.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownTriggerAvatarListItem
Individual avatar within the trigger avatar list.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownTriggerAvatarListRemainingCount
Count of remaining avatars not displayed in the trigger list.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownTriggerIcon
Icon within the visibility dropdown trigger.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContent
Content container for the visibility dropdown options.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentItemIcon
Icon for a visibility option item in the dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentItemLabel
Label for a visibility option item in the dropdown.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentUserPicker
User picker for selecting specific users when visibility is set toselected-people.
- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentUserPickerSearch
Search container within the user picker.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentUserPickerSearchIcon
Search icon within the user picker search.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentUserPickerSearchInput
Search input field within the user picker.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentUserPickerHeader
Header section of the user picker.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentUserPickerHeaderCount
Count of selected users displayed in the user picker header.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentUserPickerHeaderUnselectAll
Button to unselect all users in the user picker.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentUserPickerItem
Individual user item within the user picker.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentUserPickerItemAvatar
Avatar for a user item in the user picker.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentUserPickerItemInfo
Info text for a user item in the user picker.- React / Next.js
- Other Frameworks
VeltCommentDialogVisibilityBannerDropdownContentUserPickerItemCheck
Check indicator for a selected user in the user picker.- React / Next.js
- Other Frameworks
VeltCommentDialogSignIn
Sign-in prompt displayed to unauthenticated users.- React / Next.js
- Other Frameworks
VeltCommentDialogNavigationButton
Button for navigating between comments.- React / Next.js
- Other Frameworks
VeltCommentDialogAttachmentButton
Button for adding file attachments to a comment.- React / Next.js
- Other Frameworks
VeltCommentDialogDeviceTypeIcons
Icons indicating the device type used when the comment was created.- React / Next.js
- Other Frameworks
VeltCommentDialogCommentIndex
Display for the comment’s index position.- React / Next.js
- Other Frameworks
VeltCommentDialogCommentNumber
Display for the comment’s number.- React / Next.js
- Other Frameworks
VeltCommentDialogCommentCategory
Display for the comment’s category.- React / Next.js
- Other Frameworks
VeltCommentDialogMetadata
Display for comment metadata.- React / Next.js
- Other Frameworks
VeltCommentDialogThreads
Container for the comment threads.- React / Next.js
- Other Frameworks
VeltCommentDialogAllComment
View for displaying all comments.- React / Next.js
- Other Frameworks
VeltCommentDialogApprove
Approve button for comment approval workflows.- React / Next.js
- Other Frameworks
VeltCommentDialogUpgrade
Upgrade prompt component.- React / Next.js
- Other Frameworks
VeltCommentDialogMoreReply
Indicator showing additional replies are available.- React / Next.js
- Other Frameworks
VeltCommentDialogHideReply
Button to hide replies in a thread.- React / Next.js
- Other Frameworks
VeltCommentDialogToggleReply
Toggle control for showing or hiding replies.- React / Next.js
- Other Frameworks
VeltCommentDialogToggleReplyShow
Show-replies variant of the reply toggle.- React / Next.js
- Other Frameworks
VeltCommentDialogToggleReplyHide
Hide-replies variant of the reply toggle.- React / Next.js
- Other Frameworks
VeltCommentDialogToggleReplyCount
Reply count displayed within the reply toggle.- React / Next.js
- Other Frameworks
VeltCommentDialogSuggestionAction
Container for suggestion accept/reject actions.- React / Next.js
- Other Frameworks
VeltCommentDialogSuggestionActionAccept
Button to accept a suggestion.- React / Next.js
- Other Frameworks
VeltCommentDialogSuggestionActionReject
Button to reject a suggestion.- React / Next.js
- Other Frameworks
VeltCommentDialogCommentSuggestionStatus
Status indicator for a comment suggestion.- React / Next.js
- Other Frameworks
VeltCommentDialogAssignDropdown
Dropdown for assigning a comment to a user.- React / Next.js
- Other Frameworks
VeltCommentDialogAssignMenu
Menu for assignment options.- React / Next.js
- Other Frameworks
VeltCommentDialogOptions
Options menu for the comment thread.- React / Next.js
- Other Frameworks
VeltCommentDialogPriority
Priority selector for the comment.- React / Next.js
- Other Frameworks
VeltCommentDialogStatus
Status selector for the comment.- React / Next.js
- Other Frameworks
VeltCommentDialogCustomAnnotationDropdown
Dropdown for custom annotation categories.- React / Next.js
- Other Frameworks
Notes
- Attribute Naming: HTML uses kebab-case, React uses camelCase
- Boolean Values: HTML uses “true”/“false” strings, React uses actual booleans
- Object Values: HTML uses JSON strings, React uses actual objects
- Required vs Optional:
annotationIdis required when using standalone mode, not required inside context wrapper

