--- title: "Using lists in queries" slug: "using-lists-in-queries-2" tags: ["Install and Get Started", "NDR 4.x", "Customer", "Network Security"] updated: 2026-11-17T09:22:39Z published: 2026-11-17T09:22:39Z canonical: "docs.trellix.com/using-lists-in-queries-2" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Using lists in queries You can create lists and use them in a query or share them with other NDR users in your network. This eliminates the task of entering individual IP addresses and domains in a query. For example, you can create a list named “web_servers” and then search for any sessions for those hosts with a query such as destinationIPv4Address:web_servers. ### Creating lists Values in a list must be the same type. Each value must be entered on a separate line in the list. **To create a list using the list manager in the Web UI:** 1. Click ![Main_menu.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-0124baa3-4d5b-b290-686f-053b2ba4658f(4).png?sv=2026-02-06&spr=https&st=2026-11-19T12%3A28%3A32Z&se=2026-11-19T13%3A28%3A32Z&sr=c&sp=r&sig=TdZ%2F6BSPTtVJcJpq%2BT0rEayjsYX1pvsqxmbIYkSihm0%3D) and from **CONFIGURATION**, select **Lists**. 2. Select **+Add List**. 3. Enter the name for your list. The name must be alphanumeric with underscores and no spaces. For example, web_servers. 4. Enter the terms for the list. 5. Click **Create List**. You can filter the lists created by **Name**, **Count**, or **Type**. ### Shared lists Lists can be shared among users with access to your NDR appliance. Shared lists cannot be shared with single or select individuals. **To create a shared list using the list manager in the Web UI:** 1. Click ![Main_menu.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-0124baa3-4d5b-b290-686f-053b2ba4658f(4).png?sv=2026-02-06&spr=https&st=2026-11-19T12%3A28%3A32Z&se=2026-11-19T13%3A28%3A32Z&sr=c&sp=r&sig=TdZ%2F6BSPTtVJcJpq%2BT0rEayjsYX1pvsqxmbIYkSihm0%3D) and from **CONFIGURATION**, select **Lists**. 2. Select **+Add List**. 3. Enter the name for your list. A shared list's name must be unique across all users and must be alphanumeric with underscores and no spaces. 4. Enter the terms for the list. 5. Check the empty box next to **Share list**. 6. Click **Create List**. You can filter the lists created by **Name**, **Count**, or **Type**. ### Querying lists After you create a list, you can use it in a query after entering a field name. As you type the value of the field, you are prompted for a list name. After the query is executed, the values in the list expand in the query bar. **To query using a list in the Web UI:** 1. Click ![Main_menu.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-0124baa3-4d5b-b290-686f-053b2ba4658f(4).png?sv=2026-02-06&spr=https&st=2026-11-19T12%3A28%3A32Z&se=2026-11-19T13%3A28%3A32Z&sr=c&sp=r&sig=TdZ%2F6BSPTtVJcJpq%2BT0rEayjsYX1pvsqxmbIYkSihm0%3D) and from **INVESTIGATION**, select **Search**. 2. Enter a field name in the query bar. The field name will prompt with a list. 3. Select the list that you want to query. Shared lists are displayed to all users on the same NDR appliance when entering field names in the Query Bar. Your shared lists appear in a drop-down menu of lists shared in your NDR appliance. Shared lists are marked by a globe (![Shared_ListQuery_Icon.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-4a9176af-e82b-b69d-9f08-2330a3f5534e(4).png?sv=2026-02-06&spr=https&st=2026-11-19T12%3A28%3A32Z&se=2026-11-19T13%3A28%3A32Z&sr=c&sp=r&sig=TdZ%2F6BSPTtVJcJpq%2BT0rEayjsYX1pvsqxmbIYkSihm0%3D)) icon. ### Deleting or Editing Lists **To delete or edit a list using the list manager in the Web UI:** 1. Click ![Main_menu.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-0124baa3-4d5b-b290-686f-053b2ba4658f(4).png?sv=2026-02-06&spr=https&st=2026-11-19T12%3A28%3A32Z&se=2026-11-19T13%3A28%3A32Z&sr=c&sp=r&sig=TdZ%2F6BSPTtVJcJpq%2BT0rEayjsYX1pvsqxmbIYkSihm0%3D) and from **CONFIGURATION**, select **Lists**. 2. Select the ![3dots.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-634ea311-a6d3-1f41-1ad0-7df1084b890d(4).png?sv=2026-02-06&spr=https&st=2026-11-19T12%3A28%3A32Z&se=2026-11-19T13%3A28%3A32Z&sr=c&sp=r&sig=TdZ%2F6BSPTtVJcJpq%2BT0rEayjsYX1pvsqxmbIYkSihm0%3D) icon associated with the list you wish to edit or delete. 3. Select **Edit** or **Delete**. Existing private lists can be edited and changed into shared lists and vice versa. **To make a private list a shared list using the list manager:** 1. Click ![Main_menu.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-0124baa3-4d5b-b290-686f-053b2ba4658f(4).png?sv=2026-02-06&spr=https&st=2026-11-19T12%3A28%3A32Z&se=2026-11-19T13%3A28%3A32Z&sr=c&sp=r&sig=TdZ%2F6BSPTtVJcJpq%2BT0rEayjsYX1pvsqxmbIYkSihm0%3D) and from **CONFIGURATION**, select **Lists**. 2. Click ![3dots.png](https://cdn.us.document360.io/0d453a50-e1da-4d4a-9409-fea7959614d8/Images/Documentation/uuid-634ea311-a6d3-1f41-1ad0-7df1084b890d(4).png?sv=2026-02-06&spr=https&st=2026-11-19T12%3A28%3A32Z&se=2026-11-19T13%3A28%3A32Z&sr=c&sp=r&sig=TdZ%2F6BSPTtVJcJpq%2BT0rEayjsYX1pvsqxmbIYkSihm0%3D) icon associated with the list you wish to share and select **Edit** from the drop-down menu. 3. In the **List Setup** window, check the empty box next to **Share list**. 4. Click **Update List**. Your list is no longer private and can be accessed by others.