> ## 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 Nov 05, 2024

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.

There is also a unique Build Group called the **Universal Helpers**. Helpers in this group assist with builds from all initiators in your Incredibuild environment, regardless of Build Group. Initiators cannot be added to the Universal Helpers Build Group.

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-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/build_group_in_agent_list.png?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=51c68237bd357daf42de2c68f60f9379" alt="" width="1883" height="913" data-path="images/windows/10.31.1/windows/build_group_in_agent_list.png" />

## Creating or Edit a Build Group

1. In the Coordinator's **Agent List**, click the **Build Groups** button.

   <img src="https://mintcdn.com/incredibuild-docs-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/build_groups_manage_button.png?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=28e5dc70b0647b477b89bcdb7bf100e3" alt="" width="1440" height="900" data-path="images/windows/10.31.1/windows/build_groups_manage_button.png" />

2. Click **Add Build Group** to create a new Build Group.

   <img src="https://mintcdn.com/incredibuild-docs-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/build_groups_add.jpg?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=5f7e94625ad6351c1424f95e414ca0e9" alt="" width="1920" height="1080" data-path="images/windows/10.31.1/windows/build_groups_add.jpg" />

3. Click inside the name field and modify it to change the name of the Build Group.

   <img src="https://mintcdn.com/incredibuild-docs-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/build_groups_edit.jpg?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=91f532549e6156ce62f49466d039f06d" alt="" width="1920" height="1080" data-path="images/windows/10.31.1/windows/build_groups_edit.jpg" />

## Deleting a Build Group

To delete an existing Build Group, click Build Groups and use the trash button next to the Build Group you want to delete.

<img src="https://mintcdn.com/incredibuild-docs-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/build_groups_delete.jpg?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=6a4d27dec7d02dbf8f372e4e198744ac" alt="" width="1920" height="1080" data-path="images/windows/10.31.1/windows/build_groups_delete.jpg" />

## Using Cloud Agents in a Build Group

When you scale Incredibuild to the cloud, you enable Incredibuild to create and use Incredibuild Agents in your cloud provider. To allow you to better manage these resources, you can define when the Initiator Agents in a Build Group can use your Cloud Helper Agents or not. By default, this setting is enabling allowing all of your Initiator agents to use your Cloud Helper Agents.

<img src="https://mintcdn.com/incredibuild-docs-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/build_groups_enable_cloud.jpg?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=e051c0746438808aa3b1447175fe5786" alt="" width="1920" height="1080" data-path="images/windows/10.31.1/windows/build_groups_enable_cloud.jpg" />

## 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-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/build_groups_assign.png?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=caec936955e1a9b004cc9bb753d37f46" alt="" width="1440" height="900" data-path="images/windows/10.31.1/windows/build_groups_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-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/gifs/bulk_agent_select2.gif?s=742d6d12619bd3e4496af595c284e80c" alt="" width="1446" height="826" data-path="images/windows/10.31.1/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-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/filters_button.png?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=8e75e0812bfbd11da780d71359400a19" alt="" width="1869" height="582" data-path="images/windows/10.31.1/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-migrated/OOp4vaNql06ht_sF/images/windows/10.31.1/windows/build_groups_filter.png?fit=max&auto=format&n=OOp4vaNql06ht_sF&q=85&s=3860c3d3f7b8bb544b2df4c01d338cde" alt="" width="1909" height="936" data-path="images/windows/10.31.1/windows/build_groups_filter.png" />
