Skip to main content
Unread status is the SDK surface for showing unread counts, marking messages read or delivered, and keeping receipt state current while a chat screen is active.

Capability Map

Platform Coverage

Platform gaps are intentional documentation facts, not missing code snippets. Add a Flutter snippet for delivered users or receipt sync only after the Flutter SDK exposes a public API for that operation.

Implementation Shape

Chat List

Use channel unread fields, total unread observers, mention flags, and message previews.

Active Chat Screen

Start receipt sync where supported, render messages, and call message.markRead() when messages are seen.

Sender Feedback

Use read and delivered counts, then query receipt users where the platform exposes those APIs.

Lifecycle Cleanup

Stop receipt sync when a screen closes or switches to a different subchannel.

Data Ownership

Message Preview

Show latest-message preview data beside unread state.

Query Messages

Load message models before marking messages read.

Query Channels

Load channel models for unread count and preview fields.