# Session list

> [HTML Version](session-list-widget.html)

The **Session List** widget is used to view and filter sessions from the [Live Chats](chat_lines.md) workspace. It consists of the following components:

- A search form with parameters that supervisors and operators can use to search for sessions.

- A table with data about sessions.

The widget can be added to any page in the system, for example, a page created in the [Live Chats](chat_lines.md) workspace.

**(session-list-widget-1.png)**

## Add the widget

To add the widget to a page:

1. Click the gear icon next to the page’s name. Select **Widget Builder**. The [interface designer](interface_designer.md) will open.

2. Drag the **Session List **widget from the right-side panel of the designer to the modeling canvas or click the **+Widget** button. Read more about adding widgets in the [Add a widget to a page](360027211631.md) article.

3. In the window that opens, configure the widget.

**(session-list-widget-2.png)**

- **Name\***. The title displayed above the widget. You can change the name or link it with a variable created on the [Context](designer-tabs.md#context) tab of the interface designer. To do that, click the **(link-icon.png) **icon, then click **<Not defined>**. The value of the specified variable will be shown in the session list’s title.

- **Session status\***. Specify the status or statuses of sessions that should be included in the table: active sessions, closed sessions, or sessions in the queue.

- **Show the refresh button**. If you enable this option, a button for refreshing the data will be added above the table.

- **Displayed columns\***. Specify the fields that should be displayed in the table.

- **Sorting field**. Select the table column that data in the table will be sorted by.

	- **Ascending**. Check this box if you want entries in the table to be sorted in ascending order. If you selected a [String](360009707032.md#string) type field as the sorting field, entries will be listed in alphabetical order. If the option is disabled, entries will be shown in descending order.

- **Fields for filtering**. Add properties that should be available to use as filters to search for sessions.

## Events and System tabs

These tabs contain settings similar for all widgets. They allow you to set the widget’s visibility and access permissions, configure the widget’s behavior when the user hovers over it, etc. Read more about these settings in the [System widget settings](common_widget_settings.md) article.

To finish configuring the widget, click **Save**.

To make the page available to users, click **Save** and **Publish** on the interface designer toolbar.