Releases: GetStream/stream-chat-react
Releases Β· GetStream/stream-chat-react
v14.0.0-beta.3
Released: 2026-03-27
Diff: v14.0.0-beta.2...v14.0.0-beta.3
Full breaking changes reference: breaking-changes.md
Bug Fixes
- align message reactions vertically to the center of the message list (#3064) (55dd2e8)
- increase message list width (f81cae4)
- increase message list width (#3062) (fdf0e15)
- keep MessageList scrolled to the bottom (#3068) (91eba1b)
- reliably detect whether the click originated inside before closing mobile nav (#3061) (8d25ead)
- remove bottom padding from poll option with votes in poll results (#3059) (a55774d)
Features
v14.0.0-beta.2
Released: 2026-03-25
Diff: v14.0.0-beta.1...v14.0.0-beta.2
Full breaking changes reference: breaking-changes.md
β Breaking Changes
Removed Components
ActionsIcon,ReactionIcon,ThreadIcon,MessageErrorIconβ removed (#3050) (f4caa0e)MessageErrorTextβ removed (#3042) (e0207cd)
CSS Class Renames
| Old | New |
|---|---|
str-chat__message-error-icon |
str-chat__message-error-indicator |
Behavioral Changes
handleDeleteinMessageContextnow re-throws errors instead of swallowing them. (#3042) (e0207cd)- Users can no longer mark their own messages as unread. (#3043) (fe05b62)
β¨ Features
- Redesigned message actions icons and message error badge (#3050) (f4caa0e)
- Shared gallery preview in
AttachmentPreviewList(#3044) (f05f47d) - "Voice message deleted" notification (#3045) (9982c45)
- Prevent marking own messages as unread (#3043) (fe05b62)
π Bug Fixes
- Adjust message UI for network error when sending a message (#3042) (e0207cd)
- Calculate message read status for the first message in a channel (ported from v13) (#3056) (b7c33c8)
- Clear message composer on unmount (#3053) (f2a79ab)
- Prevent empty message composer textarea from growing (#3051) (880d12d)
- Align textarea placeholder and text with surroundings (#3052) (da293f0)
- Keep command menu distance constant from the invoking button (#3049) (960c1f9)
- Prevent poll options layout shifting upon voting (#3048) (cdaf480)
- Allow
useNotificationTargetto return undefined (#3046) (38b278e)
v13.14.3
v14.0.0-beta.1
v14.0.0-beta.1 (2026-03-23)
Migration guide: Upgrade to v14
Full breaking changes reference: breaking-changes.md
β Breaking Changes
Removed Components & Hooks
ChannelSearchβ useSearchinstead (#3014) (9a7b7a2)Modalβ useGlobalModalinsteadFixedHeightMessageβ removed entirelyMessageDeletedβ replaced byMessageDeletedBubble(rendered within the message bubble) (#2964) (446de99)MessageActionsWrapperβ droppedMessageOptions,CustomMessageActions,CustomMessageActionsList,MessageActionsBoxβ useMessageActionsinstead (#2932) (1d28279)RemindMeActionButtonβ removedQuotedPollcomponent andisQuotedprop fromPollβ removedMessageEditedTimestampβ removed (7cbe67e), replaced byMessageEditedIndicator(#3019) (7e9637a)MessageIsThreadReplyInChannelButtonIndicatorβ replaced byMessageAlsoSentInChannelIndicator(#2968) (b198029)MessageListNotificationsβ replaced byNotificationList(#3028) (e06ec62)useAudioControllerhook β migrate touseAudioPlayer(#3016) (35f8a5d)- Icons removed:
PauseIcon,PlayTriangleIcon,GeolocationIcon
Removed HOC Wrappers
All legacy higher-order context wrappers have been removed in favor of hooks (#2962) (e0cd4f2):
withChannelActionContextwithChannelStateContextwithChatContextwithComponentContextwithMessageContextwithTranslationContextwithTypingContext
Provider/hook APIs (*Provider and use*Context) remain unchanged. Helper src/context/utils/getDisplayName.ts also deleted.
Component API Changes
Channelβ no longer supports component overrides directly; useWithComponentsinstead. (#2904) (cd6001f)Avatarβ removeduserprop;imagerenamed toimageUrl;namerenamed touserName. (#2926) (2eb04ee)ReactionSelectorβ removed props:Avatar,detailedView,latest_reactions,reaction_counts,reaction_groups,reactionOptions,reverse. (#2916) (24a1169)VirtualMessageβ props changed fromFixedHeightMessagePropstoMessageUIComponentProps.MessageContextValue['handleDelete']β signature changed.MessagePropsβ removedendOfGroup,firstOfGroup, andgroupedByUser(usegroupStylesinstead).DropdownPropsβ replacedopenButtonPropswithTriggerComponent; removeddialogId.BaseImageβ now usesImageFallbackcomponent instead of CSS mask for error fallback.GroupAvatarβ renders a singleAvatarwithout wrappers whengroupChannelDisplayInfohas one entry. (#2930) (e307882)useChannelPreviewInfoβgroupChannelDisplayInfois now always defined. For 1:1 or β€2 members it returns{ members: [], overflowCount: undefined }.addNotification(fromChannelStateContext) β replaced byclient.notificationsAPI. (#3018) (83dec93)NotificationListβ moved; new parent isMessageListMainPanel.isOnlyEmojisutility β replaced bymessageTextHasEmojisOnly.handleSubmitβ removedcustomMessageDatafrom type declaration. (#2950) (fc547be)
Renamed Components
| Old Name | New Name |
|---|---|
MessageNotification |
NewMessageNotification |
ScrollToBottomButton |
ScrollToLatestMessageButton |
ReactionsListModal |
MessageReactionsDetail |
MessageDeleted |
MessageDeletedBubble |
ChannelListMessenger |
ChannelListUI (#3036) (d251338) |
MessageListNotifications / MessageListNotificationsProps |
NotificationList / NotificationListProps |
See also: (#3030) (a563248), (#3035) (7c978a9)
CSS Class Renames
Channel preview classes β all str-chat__channel-preview* renamed to str-chat__channel-list-item*:
| Old | New |
|---|---|
str-chat__channel-preview-container |
str-chat__channel-list-item-container |
Message classes:
| Old | New |
|---|---|
str-chat__message-input-cooldown |
str-chat__message-composer-cooldown |
str-chat__message-simple-name |
str-chat__message-metadata__name |
str-chat__message-simple-timestamp |
str-chat__message-metadata__timestamp |
str-chat__simple-message--error-failed |
str-chat__message-inner--error |
str-chat__channel-header-end |
str-chat__channel-header__data |
Reaction classes:
| Old | New |
|---|---|
str-chat__reaction-list |
str-chat__message-reactions |
str-chat__message-reactions |
str-chat__message-reactions__list |
str-chat__message-reaction |
str-chat__message-reactions__list-item |
str-chat__message-reaction-emoji |
str-chat__message-reactions__item-icon |
str-chat__message-reaction-count |
str-chat__message-reactions__item-count |
str-chat__reaction-list--counter |
str-chat__message-reactions__total-count |
Removed classes (no replacement):
str-chat__message-simple,str-chat__message-simple--mestr-chat__message-reactions-containerstr-chat__reaction-list--reversestr-chat__message-reaction-ownstr-chat__avatar--single,str-chat__avatar-group--three-partstr-chat_modal-inner- All
--str-chat__jump-to-latest-message-*CSS variables - All
--str-chat__message-bounce-*CSS variables
Other Breaking UI Changes
MessageReactionsDetailnow renders in a dialog instead of a modal. (#2963) (a941ed2)MessageActionsnow uses general-purposeContextMenucomponents. (#2932) (1d28279)- Suggestion list and items re-implemented with the new
ContextMenuAPI (markup changed). (#2931) (f151abc) str-chat__message-composer-containernow wraps the message composer.- Date separator no longer contains separation lines.
- Image/giphy attachments now rendered with
ModalGallery. (#2936) (a52de09) - Gallery assets must use the new
GalleryItemtype. - Removed support for
"live"label andchannel.data.subtitledisplay. ScrollToLatestMessageButtonintroduced by default in message list (with new markup).UnreadMessagesSeparatormarkup changed.
β¨ Features
Design System & Theming
- Dark theme support (#3002) ([fbe28d0](https://git...