> For the complete documentation index, see [llms.txt](https://chatlyst.gitbook.io/chatlyst-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chatlyst.gitbook.io/chatlyst-user-guide/chat/thread-list.md).

# Thread List

Use the Thread List to find and review conversations quickly.

## Thread List Functions

Thread List functions help users quickly locate, filter, and review conversations without losing context.

### Find a Conversation

Enter keywords in the **Search Bar** to locate a specific conversation.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FFE1uH4RbmZIzz7MJupMQ%2Fimage.png?alt=media&amp;token=028c0756-cc38-4422-a5c1-c32adcfe5d1c" alt=""><figcaption></figcaption></figure></div>

***

### Conversation Routing

Conversation Routing group threads into high-level categories. Conversation Routing let users switch between categories to review the right set of conversations. Please refer [Conversation Routing](/chatlyst-user-guide/chat/conversation-routing-and-statuses.md#conversation-labels) guide for more details.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FNQ2OK8SuYSmCofxorAE0%2Fimage.png?alt=media&amp;token=b8739039-784c-46e4-a7f3-bf9d20def5bf" alt=""><figcaption></figcaption></figure></div>

***

### Filters

Users can narrow down the conversation using four primary filter types:&#x20;

* [Status Filter](#status-filters)
* [Inbound Channels Filter](#inbound-channels-filter)
* [Conversation Tags Filter](#inbound-channels-filter)
* [Date Range](#date-range)

#### Status Filters

Sorts conversations by their current [status](/chatlyst-user-guide/chat/conversation-routing-and-statuses.md#conversation-statuses).

**How to Filter by Statuses:**

{% stepper %}
{% step %}
Locate the filter menu and select **All Statuses**.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FvtHqBmRUSuTYA5NAVx1E%2Fimage.png?alt=media&amp;token=461558e7-5799-4bcc-8c9f-6fbb7ae4aff6" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

1. Open the dropdown menu to view the available options and select the status or statuses to apply the filter.&#x20;
2. Once the selection is made, the thread list will automatically update to show only the results that match the chosen statuses.

{% hint style="info" %}
Multiple statuses can be selected at the same time to view chats from several statuses at once.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FqvxaJgUORnmXyyZturKY%2Fimage.png?alt=media&amp;token=f45038eb-da64-4376-95ec-a2173c4d1d05" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

#### Inbound Channels Filter

Sorts conversations by the original source platform the customer used.

**How to Filter by Channels:**

{% stepper %}
{% step %}
Locate the filter menu and select **Channels**.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FEw4qEjm1z4uTKrIeBidY%2Fimage.png?alt=media&amp;token=cf825c02-ea8a-4a51-baa3-3e1e86c7b1fc" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

1. Open the dropdown menu to view the available options.&#x20;
2. Enter a keyword into the search bar to quickly locate a specific channel, or manually scroll through the dropdown list to find the desired option.
3. Select the channel or channels to apply the filter. Once the selection is made, the thread list will automatically update to show only the results that match the chosen channels.

{% hint style="info" %}
Multiple channels can be selected at the same time to view chats from several sources at once.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FPxPwQCCFDBZdzSyZkMvs%2Fimage.png?alt=media&amp;token=3d50fdb9-271e-4232-a5cc-33e64fc6fb5f" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

#### Tags Filter

Sorts conversations by applied tags.

{% hint style="info" %}
The Tags filter is only visible and available to use if there are active tags already created within the system. For detailed instructions on how to create and manage these labels, please refer to the [Conversation Tags](/chatlyst-user-guide/settings/conversation-tags.md#conversation-tags) guide.
{% endhint %}

**How to Filter by Tags:**

{% stepper %}
{% step %}
Locate the filter menu and select **Tags**.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F04TCxVAFndykpcUCwILs%2Fimage.png?alt=media&amp;token=aacc0356-24f0-42cc-a7e7-bf130871c356" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

1. Open the dropdown menu to view all existing tags.&#x20;
2. Enter a keyword into the search bar to quickly locate a specific tag, or manually scroll through the dropdown list to find the correct option.
3. Select the tag or tags to apply the filter. Once the selection is made, the thread list will automatically update to show only the results that match the chosen tags.

{% hint style="info" %}
Multiple tags can be selected at the same time to expand the search results.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F51aNcGF7OOQT7aJTIhBT%2Fimage.png?alt=media&amp;token=2faf29b0-10aa-4653-b446-7ded40453f31" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### Date Range

Date Range limits the thread list to a specific time period (day, week, or custom dates).

**How to Filter by Date Range:**

{% stepper %}
{% step %}
Locate the filter menu and select **Select date range**.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2Fq2mlAo6I5wkIogzCIzAr%2Fimage.png?alt=media&amp;token=946dc784-3417-4d94-a2bb-dc93d01672c8" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Select a date range using either:

* The calendar view (for exact start and end dates)
* Preset ranges on the left (for common time periods)
* Once the selection is made, the thread list will automatically update to show only the results that match the choses time period.&#x20;

<div align="center" data-with-frame="true"><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F3d5nn9UaX7fXkSUPrb0A%2Fattachment%3A8a4c3196%20d2cb%204df6%208d15%203c8b540b5023%3AScreenshot_2026%2004%2023_at_2.39.23_PM.png?alt=media&amp;token=03ba8de5-0a1d-4120-babd-31a67050693b" alt="" width="375"></div>
{% endstep %}

{% step %}
Remove the filter when it is no longer needed. The filter stays active until it is turned off, which can make it look like conversations are missing later.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F96pKTfagES5FHKgBRUVI%2Fimage.png?alt=media&amp;token=0c739d68-ffe6-4841-8ff1-77e6a74f6adc" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

## Open and Review a conversation

1. Select a conversation in the Thread List.
2. Review the full message history in the Conversation Panel.
3. Reply directly in the selected thread if needed.

In the Thread List, key details are visible at a glance, including:

* Time of the most recent response
* Current conversation status

{% hint style="info" %}
Conversation priority in the Thread List follows this order (highest to lowest): Pending 1st Response > Previously Snoozed > Pending Response > Open > Bot Handling > Snoozed > Closed.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FZUiNO8Q1ePLZKzzcUNg8%2Fimage.png?alt=media&amp;token=d47acf3e-9364-4a55-aca6-0e39624e1ea3" alt=""><figcaption></figcaption></figure></div>