--- title: "Group agents using Agent Handler assignments" slug: "group-agents-using-agent-handler-assignments" tags: ["Product Usage", "ePolicy Orchestrator – On-prem", "ePO 5.10.x", "ePO 5.10.0"] updated: 2026-09-07T17:46:26Z published: 2026-09-07T17:46:26Z canonical: "docs.trellix.com/group-agents-using-agent-handler-assignments" --- > ## 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. # Group agents using Agent Handler assignments Create **Agent Handler** assignments to group Trellix Agents together. Handler assignments can specify an individual handler or a list of handlers to use. The list that you specify can be made up of individual handlers or groups of handlers. > [!TIP] > Tip > > When assigning agents to **Agent Handlers**, consider geographic proximity to reduce unnecessary network traffic. For details about product features, usage, and best practices, click ? or Help. 1. Select **Menu** → **Configuration** → **Agent Handlers**, then click the required **Handler Assignment Rule**. The **Agent Handler** Assignment page appears. > [!NOTE] > Note > > If the **Default Assignment Rules** is the only assignment in the list, you must create an assignment. 2. Type a name for the **Assignment Name**. 3. You can configure **Agent Criteria** by **System Tree** locations, by agent subnet, or individually using the following: - **System Tree Locations** — Select the group from the **System Tree location**. > [!NOTE] > Note > > You can browse to select other groups from the **Select System Tree Group** dialog box and use + and - to add and remove **System Tree** groups that are displayed. - **Agent Subnet** — In the text field, type IP addresses, IP address ranges, or subnet masks in the text box. - Individually — In the text field, type the IPv4/IPv6 address for a specific system. 4. You can configure Handler Priority to **Use all Agent Handlers** or **Use custom handler list**. Click **Use custom handler list**, then change the handler in one of these ways: - Change the associated handler by adding another handler to the list and deleting the previously associated handler. - Add additional handlers to the list and set the priority that the agent uses to communicate with the handlers. > [!NOTE] > Note > > When using a custom handler list, use + and - to add and remove additional **Agent Handlers** from the list (an **Agent Handler** can be included in more than one group). Use the drag and drop handle to change the priority of handlers. Priority determines which handler the agents try to communicate with first. 5. Click **Save**.