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

# Build Groups

Last updated on Mar 08, 2023

Build Groups allow you to limit build distribution to a select group of Agents. Each Build Group includes Initiator Agents and Helper Agents. By default, every Agent is assigned to the **Default** Build Group. You can assign an Agent to a different Build Group in the Coordinator's Agent List.

You can view the Build Group of every agent in the **Coordinator >** **Agent List**.

<img src="https://mintcdn.com/incredibuild-docs-live/-_lCMO_2iSCJJiZX/images/windows/_shared/windows/build_group_in_agent_list.png?fit=max&auto=format&n=-_lCMO_2iSCJJiZX&q=85&s=23c674b2d8c9e5e5483ccb06b918af0a" alt="" width="1807" height="648" data-path="images/windows/_shared/windows/build_group_in_agent_list.png" />

## Creating a Build Group

1. In the Coordinator's **Agent List**, click the three dots menu next to the agent.

   <img src="https://mintcdn.com/incredibuild-docs-live/_KYVHj8H_EaDWYv0/images/windows/_shared/windows/agent_list_three_dots.png?fit=max&auto=format&n=_KYVHj8H_EaDWYv0&q=85&s=b42177c4ce542bc5a2df0b875a68658a" alt="" width="1808" height="653" data-path="images/windows/_shared/windows/agent_list_three_dots.png" />

2. Click **Build Group** and type the Build Group name in the **Create / Search** box.

   <img src="https://mintcdn.com/incredibuild-docs-live/-_lCMO_2iSCJJiZX/images/windows/_shared/windows/build_group_new_name.png?fit=max&auto=format&n=-_lCMO_2iSCJJiZX&q=85&s=5655f82b0232e494c3ec9a01119e37ae" alt="" width="1807" height="856" data-path="images/windows/_shared/windows/build_group_new_name.png" />

3. Click <img src="https://mintcdn.com/incredibuild-docs-live/-_lCMO_2iSCJJiZX/images/windows/_shared/windows/coordinator_10/build_group_plus_icon.png?fit=max&auto=format&n=-_lCMO_2iSCJJiZX&q=85&s=e85cb87c77b3e4896ee08eec53cdd661" alt="" width="16" height="15" data-path="images/windows/_shared/windows/coordinator_10/build_group_plus_icon.png" />. The Build Group is created, and assigned to the Agent.

## Assigning Agents to a Build Group

1. In the Coordinator's **Agent List**, click the three dots menu next to the agent.

   <img src="https://mintcdn.com/incredibuild-docs-live/_KYVHj8H_EaDWYv0/images/windows/_shared/windows/agent_list_three_dots.png?fit=max&auto=format&n=_KYVHj8H_EaDWYv0&q=85&s=b42177c4ce542bc5a2df0b875a68658a" alt="" width="1808" height="653" data-path="images/windows/_shared/windows/agent_list_three_dots.png" />

2. Click **Build Groups** and select an existing Build Group. You can use the search box to narrow the results.

   <img src="https://mintcdn.com/incredibuild-docs-live/-_lCMO_2iSCJJiZX/images/windows/_shared/windows/build_group_assign.png?fit=max&auto=format&n=-_lCMO_2iSCJJiZX&q=85&s=764fcf26a10d53862c52b59c11151a84" alt="" width="1809" height="808" data-path="images/windows/_shared/windows/build_group_assign.png" />

3. To assign multiple agents at once, select the agents and use the **Actions** menu options.

   <img src="https://mintcdn.com/incredibuild-docs-live/_KYVHj8H_EaDWYv0/images/windows/_shared/windows/agent_list_bulk_select.png?fit=max&auto=format&n=_KYVHj8H_EaDWYv0&q=85&s=a5747b4b04e06b6a0d872a6d61a091e3" alt="" width="1816" height="700" data-path="images/windows/_shared/windows/agent_list_bulk_select.png" />

## Viewing all Agents in a Build Group

1. In the Coordinator's Agent List, click the **Filter**.

   <img src="https://mintcdn.com/incredibuild-docs-live/_KYVHj8H_EaDWYv0/images/windows/_shared/windows/agent_list_filter_button.png?fit=max&auto=format&n=_KYVHj8H_EaDWYv0&q=85&s=0d23a14bccc7069c45ad2b81feb03690" alt="" width="1812" height="604" data-path="images/windows/_shared/windows/agent_list_filter_button.png" />

2. Expand the **Build Groups** section, and select the Build Groups you want to display.

   <img src="https://mintcdn.com/incredibuild-docs-live/-_lCMO_2iSCJJiZX/images/windows/_shared/windows/build_groups_filter.png?fit=max&auto=format&n=-_lCMO_2iSCJJiZX&q=85&s=2128269a8d4eee37cc3dc634d863254d" alt="" width="1891" height="703" data-path="images/windows/_shared/windows/build_groups_filter.png" />

## Limitations

Build groups cannot be deleted, and their names can not be changed after creation.

[https://docs.incredibuild.com/Default.htm](https://docs.incredibuild.com/Default.htm)

[https://docs.incredibuild.com/lin/latest/Default.htm](https://docs.incredibuild.com/lin/latest/Default.htm)

[https://docs.incredibuild.com/win/v10\_2\_2/Default.htm](https://docs.incredibuild.com/win/v10_2_2/Default.htm)

[https://docs.incredibuild.com/cloud/Default.htm](https://docs.incredibuild.com/cloud/Default.htm)

Windowshttps\://[www.incredibuild.com/](http://www.incredibuild.com/) 10.2.2
