Skip to content

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

Prop Description Type
message Message 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.

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