> ## 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 14, 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 Monitor >** **Agent List's** **Build Group** column.

<img src="https://mintcdn.com/incredibuild-docs-live/p1PDJsQjAbPwdXdK/images/windows/10.3/windows/build_group_in_agent_list.png?fit=max&auto=format&n=p1PDJsQjAbPwdXdK&q=85&s=f7c3d55f1c0d878fd0a03616a4e1a764" alt="" width="1883" height="913" data-path="images/windows/10.3/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 an Agent, 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_create.png?fit=max&auto=format&n=-_lCMO_2iSCJJiZX&q=85&s=7e1a098d2f7125e17a7bb26ec30c9a5c" alt="" width="1872" height="921" data-path="images/windows/_shared/windows/build_group_create.png" />

2. 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 an agent, 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/p1PDJsQjAbPwdXdK/images/windows/10.3/windows/build_group_assign.png?fit=max&auto=format&n=p1PDJsQjAbPwdXdK&q=85&s=a2643fc574ead37626786b0299bc203d" alt="" width="1872" height="921" data-path="images/windows/10.3/windows/build_group_assign.png" />

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

   <img src="https://mintcdn.com/incredibuild-docs-live/p1PDJsQjAbPwdXdK/images/windows/10.3/windows/gifs/bulk_agent_select2.gif?s=e611a20923b6f8bdb25075e506f8c15c" alt="" width="1446" height="826" data-path="images/windows/10.3/windows/gifs/bulk_agent_select2.gif" />

## Viewing all Agents in a Build Group

1. In the Agent List, click **Filters**.

   <img src="https://mintcdn.com/incredibuild-docs-live/-_lCMO_2iSCJJiZX/images/windows/_shared/windows/filters_button.png?fit=max&auto=format&n=-_lCMO_2iSCJJiZX&q=85&s=b44b253e57f49e1fe0a2203741efa308" alt="" width="1869" height="582" data-path="images/windows/_shared/windows/filters_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/p1PDJsQjAbPwdXdK/images/windows/10.3/windows/build_groups_filter.png?fit=max&auto=format&n=p1PDJsQjAbPwdXdK&q=85&s=4ad2ad5035478fb01ca58aecba17f27b" alt="" width="1909" height="936" data-path="images/windows/10.3/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/latest/Default.htm](https://docs.incredibuild.com/win/latest/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.3.0
