Conversation list filters
Conversation list filters are currently only available on the Inbox for the classic JavaScript and React SDKs, and on the Conversation list for the React Native and Flutter SDKs. They're also supported through the REST API.
Conversation list filters let you control which conversations appear in a user’s inbox or conversation list. You can filter conversations based on properties such as unread status, creation time, subject, or custom fields.
These filters are useful when you want to:
- Highlight recent or active conversations
- Show only conversations with unread messages
- Segment conversations by topic, sender, or type
- Create custom channels based on conversation properties
- Exclude read-only or restricted conversations
To filter conversations, you can use a range of different filter types. For example, you can filter by:
- Unread messages: Show or hide conversations with unread messages.
- Created time: Show only conversations created before, after, or within a specific time range.
- Most recent message: Filter based on when the last message in the conversation was sent.
- Subject: Include or exclude conversations of which the subject matches a given string.
- Access permissions: Filter based on the user's access permissions to each conversation.
- Custom properties: Filter based on custom fields, for example only conversations with the category
shoes
.
You can combine multiple filters to match complex conditions, or clear all filters to show all conversations.
Learn how to set up and combine conversation list filters in your SDK of choice: