# ChannelPreviewUnreadCount

Renders unread count inside [`ChannelList`](/chat/docs/sdk/react-native/v8/core-components/channel-list/). This is the default component for the [`PreviewUnreadCount`](/chat/docs/sdk/react-native/v8/core-components/channel-list#previewunreadcount/) prop.

## Best Practices

- Clamp counts with `maxUnreadCount` to avoid overflow.
- Hide the badge when `unread` is zero.
- Keep badge size consistent across the list.
- Use channel-level unread counts for accuracy.
- Avoid expensive formatting in render.

## Props

### `channel`

Channel instance from the Stream Chat client.

| Type                                                |
| --------------------------------------------------- |
| [Channel](/chat/docs/javascript/creating_channels/) |


### `maxUnreadCount`

Max number shown in the unread badge.
The value cannot exceed the backend limit of 255.

| Type   | Default |
| ------ | ------- |
| number | 255     |

### `unread`

Number of unread messages in the channel.

| Type   |
| ------ |
| number |


---

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

For the most recent version of this documentation, visit [https://getstream.io/chat/docs/sdk/react-native/v8/ui-components/channel-preview-unread-count/](https://getstream.io/chat/docs/sdk/react-native/v8/ui-components/channel-preview-unread-count/).