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:

  • MessagePinnedHeader
  • MessageReminderHeader
  • MessageSavedForLaterHeader
  • SentToChannelHeader

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.

TypeDefault
ComponentTypeMessagePinnedHeader

MessageReminderHeader

Reminder header component.

TypeDefault
ComponentTypeMessageReminderHeader

MessageSavedForLaterHeader

Saved-for-later header component.

TypeDefault
ComponentTypeMessageSavedForLaterHeader

SentToChannelHeader

Sent-to-channel header component.

TypeDefault
ComponentTypeSentToChannelHeader