# PollOptionFullResults

A component all of the votes for a specific `Poll` option. The results will be paginated and updated as they change. Needs to be structured inside a [`Channel` component](/chat/docs/sdk/react-native/v8/core-components/channel/).

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

To access the paginated list of votes, the `usePollOptionVotesPagination` hook can be used.

## Best Practices

- Render inside `Channel` to ensure poll context is available.
- Use `usePollOptionVotesPagination` for paginated vote lists.
- Keep full results in a modal or separate screen to reduce clutter.
- Use `PollOptionFullResultsContent` for UI changes without rewriting logic.
- Avoid loading too many votes at once for performance.

## General Usage

```tsx
import {
  OverlayProvider,
  Chat,
  Channel,
  PollOptionFullResults,
} from "stream-chat-react-native";

const App = () => {
  return (
    <OverlayProvider>
      <Chat client={client}>
        <Channel channel={channel}>
          <PollOptionFullResults
            message={message}
            poll={poll}
            {...otherOptionalProps}
          />
        </Channel>
      </Chat>
    </OverlayProvider>
  );
};
```

## Props

### message

Message object.

| Type           |
| -------------- |
| `Message` type |


### `poll` \*

An instance of the [`Poll` class](https://github.com/GetStream/stream-chat-js/blob/master/src/poll.ts) containing reactive state.

It is used by the underlying `usePollContext`, `usePollStateStore` and `usePollState` hooks to provide us with the reactive `Poll` state.

<admonition type="note">

If you need the `Poll` instance you may get it from `client.polls.fromState(pollId)`.

</admonition>

| Type   |
| ------ |
| object |


### `option` \*

The `poll` option that we want to display the results for.

| Type   |
| ------ |
| object |

### `additionalFlatListProps`

A prop used to override the underlying [`FlatList`](https://reactnative.dev/docs/flatlist#props) props of the `PollOptionFullResults`.

```tsx
const flatListProps = { bounces: true };

<PollOptionFullResults additionalFlatListProps={flatListProps} />;
```

| Type   |
| ------ |
| object |

### `PollOptionFullResultsContent`

A `Component` prop used to render the content of the `PollOptionFullResults` component.

The component has full access to the entire `Poll` reactive state through the `usePollState` hook.

| Type          | Default                                                                                                                                                    |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ComponentType | [`PollOptionFullResultsContent`](https://github.com/GetStream/stream-chat-react-native/v8/blob/main/package/src/components/Poll/PollOptionFullResults.tsx) |

#### Usage

```tsx
import { Text, FlatList } from "react-native";
import {
  OverlayProvider,
  Chat,
  Channel,
  PollOptionFullResults,
  usePollOptionVotesPagination,
  usePollState,
} from "stream-chat-react-native";

// will only display the first page of votes without loading more
const MyPollOptionFullResultsContent = ({ option }) => {
  const { name } = usePollState();
  const { votes } = usePollOptionVotesPagination({ option });
  return (
    <FlatList
      ListHeaderComponent={() => <Text>{name}</Text>}
      data={votes}
      renderItem={({ item }) => <Text>{item.id}</Text>}
    />
  );
};

const App = () => {
  return (
    <OverlayProvider>
      <Chat client={client}>
        <Channel channel={channel}>
          <PollOptionFullResults
            message={message}
            poll={poll}
            option={option}
            PollOptionFullResultsContent={MyPollOptionFullResultsContent}
          />
        </Channel>
      </Chat>
    </OverlayProvider>
  );
};
```


---

This page was last updated at 2026-04-17T17:33:45.019Z.

For the most recent version of this documentation, visit [https://getstream.io/chat/docs/sdk/react-native/v8/ui-components/poll-option-full-results/](https://getstream.io/chat/docs/sdk/react-native/v8/ui-components/poll-option-full-results/).