> ## 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.

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/aSMvimpjCo_OEPAc/images/linux/4.18.0/linux/linux_4/build_groups_1.jpg?fit=max&auto=format&n=aSMvimpjCo_OEPAc&q=85&s=7feec6ead0cbe87d278e64d1dd8e9ef8" alt="" width="1908" height="271" data-path="images/linux/4.18.0/linux/linux_4/build_groups_1.jpg" />

## Creating or Edit a Build Group

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

   <img src="https://mintcdn.com/incredibuild-docs-migrated/aSMvimpjCo_OEPAc/images/linux/4.18.0/linux/linux_4/build_groups_1b.jpg?fit=max&auto=format&n=aSMvimpjCo_OEPAc&q=85&s=d1779259b3b02a573f82681f1f4f4762" alt="" width="1908" height="271" data-path="images/linux/4.18.0/linux/linux_4/build_groups_1b.jpg" />

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

   <img src="https://mintcdn.com/incredibuild-docs-migrated/aSMvimpjCo_OEPAc/images/linux/4.18.0/linux/linux_4/build_groups_2.jpg?fit=max&auto=format&n=aSMvimpjCo_OEPAc&q=85&s=227e16c749bba75c2c1a1eb7bf57a7b2" alt="" width="1909" height="808" data-path="images/linux/4.18.0/linux/linux_4/build_groups_2.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/aSMvimpjCo_OEPAc/images/linux/4.18.0/linux/linux_4/build_groups_3.jpg?fit=max&auto=format&n=aSMvimpjCo_OEPAc&q=85&s=e91db811cebf5aec90c39cf5656d05c3" alt="" width="1912" height="903" data-path="images/linux/4.18.0/linux/linux_4/build_groups_3.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/aSMvimpjCo_OEPAc/images/linux/4.18.0/linux/linux_4/build_groups_5.jpg?fit=max&auto=format&n=aSMvimpjCo_OEPAc&q=85&s=74809b2f128cfcb645fb030ae539523d" alt="" width="1852" height="697" data-path="images/linux/4.18.0/linux/linux_4/build_groups_5.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/aSMvimpjCo_OEPAc/images/linux/4.18.0/linux/linux_4/build_groups_1b.jpg?fit=max&auto=format&n=aSMvimpjCo_OEPAc&q=85&s=d1779259b3b02a573f82681f1f4f4762" alt="" width="1908" height="271" data-path="images/linux/4.18.0/linux/linux_4/build_groups_1b.jpg" />

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

   <img src="https://mintcdn.com/incredibuild-docs-migrated/aSMvimpjCo_OEPAc/images/linux/4.18.0/linux/linux_4/agent_select_multiple.jpg?fit=max&auto=format&n=aSMvimpjCo_OEPAc&q=85&s=31376d66a908ff40597248b189f88c2d" alt="" width="1829" height="424" data-path="images/linux/4.18.0/linux/linux_4/agent_select_multiple.jpg" />

3. Click **Add to Build Group**.

   <img src="https://mintcdn.com/incredibuild-docs-migrated/aSMvimpjCo_OEPAc/images/linux/4.18.0/linux/linux_4/agent_select_multiple2.jpg?fit=max&auto=format&n=aSMvimpjCo_OEPAc&q=85&s=e79055387049847e70d9a311b4fa9dbe" alt="" width="1871" height="396" data-path="images/linux/4.18.0/linux/linux_4/agent_select_multiple2.jpg" />

## Viewing all Agents in a Build Group

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

   <img src="https://mintcdn.com/incredibuild-docs-migrated/aSMvimpjCo_OEPAc/images/linux/4.18.0/linux/linux_4/filters.jpg?fit=max&auto=format&n=aSMvimpjCo_OEPAc&q=85&s=8de512564d1b928208e7fa4f39be1512" alt="" width="1866" height="381" data-path="images/linux/4.18.0/linux/linux_4/filters.jpg" />

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

   <img src="https://mintcdn.com/incredibuild-docs-migrated/aSMvimpjCo_OEPAc/images/linux/4.18.0/linux/linux_4/filters_build_groups.jpg?fit=max&auto=format&n=aSMvimpjCo_OEPAc&q=85&s=3a2f30728ff99d92f1331f89deb111c9" alt="" width="1918" height="508" data-path="images/linux/4.18.0/linux/linux_4/filters_build_groups.jpg" />

[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)

rLinuxhttps\://[www.incredibuild.com/4.18](http://www.incredibuild.com/4.18)
