This is beta documentation for Stream Chat React Native SDK v9. For the latest stable version, see the latest version (v8)
.
MessageHeader
Renders the message header area inside MessageList. It conditionally displays pinned, reminder, saved-for-later, and sent-to-channel headers.
Migration Notes
In v9, MessageHeader primarily reads from useMessageContext() and useMessagesContext(). Custom implementations should not assume the old v8 prop bag from MessageSimple is still passed through.
If you only want to change one header variant, prefer overriding the dedicated components instead of rewriting MessageHeader:
MessagePinnedHeaderMessageReminderHeaderMessageSavedForLaterHeaderSentToChannelHeader
Best Practices
- Keep header overrides compact to avoid row height jumps.
- Let built-in visibility rules drive when headers appear.
- Reuse theme styles to keep header variants consistent.
- Avoid adding heavy async work in header components.
- Prefer component overrides over rewriting
MessageHeader.
Props
message
Message object.
| Type |
|---|
Message type |
message is the only public prop on MessageHeader. Other values such as alignment come from useMessageContext().
UI Component Props
MessagePinnedHeader
Pinned message header component.
| Type | Default |
|---|---|
| ComponentType | MessagePinnedHeader |
MessageReminderHeader
Reminder header component.
| Type | Default |
|---|---|
| ComponentType | MessageReminderHeader |
MessageSavedForLaterHeader
Saved-for-later header component.
| Type | Default |
|---|---|
| ComponentType | MessageSavedForLaterHeader |
SentToChannelHeader
Sent-to-channel header component.
| Type | Default |
|---|---|
| ComponentType | SentToChannelHeader |