> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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-migrated/9jGSsbGYGfxI35rU/images/windows/_shared/windows/build_group_in_agent_list.png?fit=max&auto=format&n=9jGSsbGYGfxI35rU&q=85&s=0f39508dd950aaffa65eb35bf4225e66" 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-migrated/vMZ2Eg_M0trNsF2G/images/windows/_shared/windows/agent_list_three_dots.png?fit=max&auto=format&n=vMZ2Eg_M0trNsF2G&q=85&s=cb0ec8dd3c57a928abf98b60f45f4c30" 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-migrated/9jGSsbGYGfxI35rU/images/windows/_shared/windows/build_group_new_name.png?fit=max&auto=format&n=9jGSsbGYGfxI35rU&q=85&s=451cdd306534904e7e400b9a31450656" 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-migrated/9jGSsbGYGfxI35rU/images/windows/_shared/windows/coordinator_10/build_group_plus_icon.png?fit=max&auto=format&n=9jGSsbGYGfxI35rU&q=85&s=f9672191ff84b86b0ea1287339a89a32" 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-migrated/vMZ2Eg_M0trNsF2G/images/windows/_shared/windows/agent_list_three_dots.png?fit=max&auto=format&n=vMZ2Eg_M0trNsF2G&q=85&s=cb0ec8dd3c57a928abf98b60f45f4c30" 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-migrated/9jGSsbGYGfxI35rU/images/windows/_shared/windows/build_group_assign.png?fit=max&auto=format&n=9jGSsbGYGfxI35rU&q=85&s=03c29b161cf975aaf8c5d8dd72a447a0" 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-migrated/vMZ2Eg_M0trNsF2G/images/windows/_shared/windows/agent_list_bulk_select.png?fit=max&auto=format&n=vMZ2Eg_M0trNsF2G&q=85&s=434f682097500c9e453c600e73079f4c" 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-migrated/vMZ2Eg_M0trNsF2G/images/windows/_shared/windows/agent_list_filter_button.png?fit=max&auto=format&n=vMZ2Eg_M0trNsF2G&q=85&s=aae2b83e7b70dfa619514bd380c589eb" 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-migrated/9jGSsbGYGfxI35rU/images/windows/_shared/windows/build_groups_filter.png?fit=max&auto=format&n=9jGSsbGYGfxI35rU&q=85&s=080f527ed3f482224fac3e9dfca8edc7" 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
