Poll

A component used to render a poll within a MessageList. Needs to be structured inside a Channel component.

It will render its default PollContent, which can be overridden for custom UI. Its children have access to the entire poll state through the usePollState hook.

Best Practices

• Render polls inside Channel to access poll context and state.
• Use PollContent overrides for UI changes without rewriting poll logic.
• Rely on usePollState for data instead of duplicating poll state.
• Handle missing or expired polls gracefully.
• Keep poll UI compact to avoid list clutter.

Props

UI Component Overrides

The PollContent UI component is not passed as a prop on Poll. Instead, override it through the WithComponents provider higher in the tree; the component reads it from useComponentsContext().

import { WithComponents, Channel } from "stream-chat-react-native";

<WithComponents overrides={{ PollContent: MyPollContent }}>
  <Channel channel={channel}>{/* MessageList renders Poll */}</Channel>
</WithComponents>;