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 explicit prop bag from the previous message row component 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

PropDescriptionType
messageMessage object. message is the only public prop on MessageHeader. Other values such as alignment come from useMessageContext().Message type

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