> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Inbox filters and sorting

> Build AND/OR session filters in the OpenCX inbox, sort and group the list, and save the result as a personal or shared view for your team.

The filters menu narrows the inbox to the sessions you care about, such as open sessions waiting on an agent, sessions the AI handed off, or sessions with a breached SLA. Combine filters with AND and OR, pick a sort order and grouping, then save the result as a view so you and your team can return to it.

> [!NOTE]
>
> Select the sliders button beside the view name in your [OpenCX inbox](https://platform.open.cx/inbox), or press **M**. Changing filters requires **Personal inbox views** or **Shared inbox views** in [Roles](https://docs.open.cx/security/roles.md). Members with neither see the filters read-only.

## Build a filter

**1. Open the filters menu**

Select the sliders button or press **M**. A number on the button shows how many filters are set.

**2. Add a filter**

Select **Add filter**, then pick a filter from **Select filter**. You can type to search the list.

**3. Choose is or is not**

Most filters offer **is** and **is not**. Date filters offer **between** and **not between**. **Waiting On** only offers **is**.

**4. Pick a value**

Each filter takes one value. The list updates as soon as you pick it.

**5. Add more conditions**

Select **+** under a group and choose **AND** to add a condition to that group, or **OR** to start a new group.

Hover a filter and select **×** to remove it. **Clear All** removes every filter. Your changes apply to the current view straight away and show as **Unsaved filters** (a dot beside the view name) until you [save them](#save-filters-as-a-view).

### How AND and OR combine

Filters inside one group must all match. Groups are separated by **OR**, and a session appears when it matches any one group.

Because each filter holds a single value, use OR groups to match several values of the same field. For example, to list open sessions tagged either **Refund** or **Chargeback**:

* Group 1: **Status** is **Open** AND **Tag** is **Refund**
* OR group 2: **Status** is **Open** AND **Tag** is **Chargeback**

Repeat the shared conditions in every group: a condition in one group does not apply to the others.

## Filter reference

Filters appear in one searchable list. They are grouped here by what they look at.

### Status and ownership

| Filter | Matches sessions | Values |
| - | - | - |
| **Status** | In the chosen main status | **Open**, **Closed — resolved**, **Closed — unresolved** |
| **Custom Status** | With the chosen custom status | Your [custom statuses](https://docs.open.cx/ticketing/custom-statuses.md) |
| **Snooze** | In or out of Snooze. Shown only when session snoozing is on, with native OpenCX ticketing | **In Snooze**, **Not in Snooze**, **All** |
| **Assignee** | Assigned to a person | **Current User** (whoever views the list), **Unassigned**, the AI agent, or a teammate |
| **Team** | Assigned to a team | **Unassigned** (no team) or a team |
| **Support Team** | In a support team's queue | **Unassigned** or a team whose support status is enabled |
| **Waiting On** | **Customers**: the AI or an agent wrote last. **Human agents**: the customer wrote last, or the AI handed off, and the session is not with the AI | **Customers**, **Human agents** |
| **Priority** | At the chosen priority. Shown only when [session priority](https://docs.open.cx/inbox/intro.md#set-session-priority) is on | Your standard and custom priorities |

### AI

| Filter | Matches sessions | Values |
| - | - | - |
| **AI Status** | Where the AI ended the session this way | **Resolved**, **Assumed resolved**, **Handed off** |
| **AI Mode** | Handled in this AI mode | **Assist mode**, **Autopilot** |
| **Instruction** | Where the AI used this instruction in a reply | Any instruction |
| **Action** | Where the AI ran this action | Any action |
| **KB article** | Where the AI used this knowledge base article in a reply | Any article (searchable) |
| **Sentiment** | With the detected customer sentiment | **Happy**, **Neutral**, **Angry** |

Some workspaces show **Assumed resolved** sessions as **Resolved**. In those workspaces **Assumed resolved** is not offered, and **Resolved** (or **is not Resolved**) covers both.

### Session details

| Filter | Matches sessions | Values |
| - | - | - |
| **Channel** | On the chosen channel | Any channel |
| **Language** | In the detected language | Any language |
| **Tag** | Carrying the tag | Any tag |
| **Contact** | Belonging to one contact | Search by contact |
| **Session Type** | Linked to sub-sessions | **Sub-session**, **Has sub-sessions** |
| **Session number** | With this exact number | A number |
| **Created At** | Created in the range | **Today**, **Last 3 days**, **Last 7 days**, or calendar dates |
| **Resolved At** | Resolved in the range. Sessions never resolved never match, even with **not between** | Same as **Created At** |
| **Closing Reason** | Whose closing reason is exactly this text | Text, for example `Resolved by workflow` |
| **SLA Status** | Where an SLA metric has this status | Metric: **Any metric**, **First reply**, **Next reply**, **Resolution**. Status: **Active**, **Breached**, **Fulfilled**, **Completed after breach**, **Paused** |
| **Source Email** | That arrived at this address of yours (not the customer's address) | An email address |
| **WhatsApp Number** | On one of your WhatsApp numbers | Your WhatsApp numbers |
| **Phone Line** | Calls in on, or out from, one of your verified phone numbers | Your phone lines |
| **Sequence** | Where the contact replied to, or answered a call from, an outbound sequence | **Any sequence** or one sequence |

**Today**, **Last 3 days** and **Last 7 days** are worked out each time the list loads, in your own timezone, so a saved "Today" view always shows the current day for whoever opens it.

### Custom data

| Filter | Matches sessions | Values |
| - | - | - |
| **Session Custom Data** | Where a session attribute key equals the value | A key (suggested as you type) and a value |
| **Contact Custom Data** | Whose contact has an attribute key that equals the value | A key and a value |

The value must match exactly. **is not** sits between the key and the value.

### Linked tickets and conversations

Use these to find the session behind a record in a connected system. Each takes the exact ID or number.

| Filter | Looks up |
| - | - |
| **Zendesk Ticket ID** | A Zendesk ticket |
| **HubSpot Ticket ID** | A HubSpot ticket or conversation |
| **Intercom Conversation ID** | An Intercom conversation |
| **Freshchat Conversation ID** | A Freshchat conversation |
| **Front Conversation ID** | A Front conversation |
| **Infobip Conversation ID** | An Infobip conversation |
| **Twilio Flex Conversation SID** | A Twilio Flex conversation |
| **Gorgias Ticket ID** | A Gorgias ticket |
| **Salesforce Case Number** | A Salesforce case |

## Sort the list

Under **SORT BY**, pick a field, then **Descending** or **Ascending**. New views start on **Last message**, **Descending**.

| Sort | Order | Availability |
| - | - | - |
| **Last message** | By the time of the latest message. Sessions with no messages come last | Always |
| **Created at** | By when the session was created | Always |
| **SLA Urgency** | By the nearest active SLA deadline. **Ascending** puts the most urgent first. Sessions without an active SLA timer come last in either direction | Always; useful once [SLA policies](https://platform.open.cx/settings/sla) apply |
| **Priority** | By your workspace's priority order, highest first when descending. Same-priority sessions follow last activity | Only when [session priority](https://docs.open.cx/inbox/intro.md#set-session-priority) is on |
| **Snooze time** | By scheduled wake-up time. Sessions without one come last | Only on a view already sorted by it, such as the built-in **Snoozed** view |

If session priority is turned off, views sorted by **Priority** fall back to the default sort.

## Group the list

Under **GROUP BY**, choose **None**, **Channel**, **Assignee**, **Status**, **Custom status**, **AI Status**, **Language**, **Support Team**, **Tags**, **Contact attribute** or **Session attribute**. For an attribute, also pick or type its key. Only loaded sessions are grouped. Group headers, counts and collapsing are covered in [Group sessions](https://docs.open.cx/inbox/intro.md#group-sessions).

## Save filters as a view

A view stores its filters, sort and grouping. Open the view menu (select the view name, or press **V**) or the views sidebar's **Manage views**, then choose:

* **Save**: update the current view with your changes. Shown only for a view you can edit, after you change it. Everyone with access to the view sees the update.
* **Save as**: create a new view from the current filters.
* **Create**: build a new view from scratch, with its own filters, sorting and grouping.

In the dialog, enter a **Name** and decide who can see the view:

| Choice under **Who can view** | Result |
| - | - |
| Leave **Allowed users** and **Allowed teams** empty | Shared with everyone in the workspace |
| Pick users, teams, or both | Shared with those people and team members |
| Pick only yourself under **Allowed users** | Personal view, visible only to you |

Shared views can also get a **Category**, which groups them in the views sidebar. The creator and anyone who can manage shared views can edit or delete a shared view. See [Views sidebar](https://docs.open.cx/inbox/intro.md#views-sidebar) for categories, ordering and filtering the list of views.

### Who can do what

| Permission in Settings → Roles | What it allows |
| - | - |
| **Personal inbox views** | Change filters and save personal views. Without **Shared inbox views**, the dialog has no sharing fields and says **Only you will be able to see and edit this view.** |
| **Shared inbox views** (write) | Create, share, edit and delete shared views, including other people's |
| **Inbox** write (or **Team sessions** / **Assigned sessions** write) | Required to save any view |

## Troubleshooting

| Symptom | Likely cause | Fix |
| - | - | - |
| The filters menu is greyed out | Your role has neither **Personal inbox views** nor **Shared inbox views** | Ask an admin to add one in [Roles](https://docs.open.cx/security/roles.md) |
| **Snooze** or **Priority** is missing from the filter list | Session snoozing or session priority is off, or your workspace does not use native OpenCX ticketing | Turn it on under [Settings → Workspace → Sessions](https://platform.open.cx/settings/workspace) |
| "You can create shared views only…" when saving | Your role has **Shared inbox views** but not **Personal inbox views** | Share with another member or team, or leave both lists empty to share with everyone |
| **Save** does not appear in the view menu | The view is a built-in view, has no unsaved changes, or you cannot edit it | Use **Save as** to keep your filters in a new view |

***

## Related Documentation

> [card] [Inbox](https://docs.open.cx/inbox/intro.md)
>
> Views sidebar, grouping and sessions

> [card] [Keyboard shortcuts](https://docs.open.cx/inbox/keyboard-shortcuts.md)
>
> M, V and the command menu

> [card] [Roles](https://docs.open.cx/security/roles.md)
>
> Grant view permissions

> [card] [Workspace settings](https://docs.open.cx/ticketing/workspace-settings.md)
>
> Shared view order and defaults


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.