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

![](https://mintcdn.com/incredibuild-docs-migrated/QZKLvexHBXC-IhOu/images/linux/_shared/linux/linux_4/build_groups_1.jpg?fit=max\&auto=format\&n=QZKLvexHBXC-IhOu\&q=85\&s=1cf53475be2630f3b352cc26a9f05db6)

## Creating or Edit a Build Group

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

   ![](https://mintcdn.com/incredibuild-docs-migrated/QZKLvexHBXC-IhOu/images/linux/_shared/linux/linux_4/build_groups_1b.jpg?fit=max\&auto=format\&n=QZKLvexHBXC-IhOu\&q=85\&s=06e66cba2e214cd259af352b5933a1fa)

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

   ![](https://mintcdn.com/incredibuild-docs-migrated/QZKLvexHBXC-IhOu/images/linux/_shared/linux/linux_4/build_groups_2.jpg?fit=max\&auto=format\&n=QZKLvexHBXC-IhOu\&q=85\&s=4a067c46825267beed9408917569b646)

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

   ![](https://mintcdn.com/incredibuild-docs-migrated/QZKLvexHBXC-IhOu/images/linux/_shared/linux/linux_4/build_groups_3.jpg?fit=max\&auto=format\&n=QZKLvexHBXC-IhOu\&q=85\&s=dd17575be989d6841507ede4ec4afbee)

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

![](https://mintcdn.com/incredibuild-docs-migrated/QZKLvexHBXC-IhOu/images/linux/_shared/linux/linux_4/build_groups_5.jpg?fit=max\&auto=format\&n=QZKLvexHBXC-IhOu\&q=85\&s=b54f73f3d682314313091610d333f0b8)

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

   ![](https://mintcdn.com/incredibuild-docs-migrated/QZKLvexHBXC-IhOu/images/linux/_shared/linux/linux_4/build_groups_1b.jpg?fit=max\&auto=format\&n=QZKLvexHBXC-IhOu\&q=85\&s=06e66cba2e214cd259af352b5933a1fa)

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

   ![](https://mintcdn.com/incredibuild-docs-migrated/QZKLvexHBXC-IhOu/images/linux/_shared/linux/linux_4/agent_select_multiple.jpg?fit=max\&auto=format\&n=QZKLvexHBXC-IhOu\&q=85\&s=2416d4e10e91acac5cc9e23a2c894c40)

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

   ![](https://mintcdn.com/incredibuild-docs-migrated/QZKLvexHBXC-IhOu/images/linux/_shared/linux/linux_4/agent_select_multiple2.jpg?fit=max\&auto=format\&n=QZKLvexHBXC-IhOu\&q=85\&s=c940c91b04665682322b7fa3a797df32)

## Viewing all Agents in a Build Group

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

   ![](https://mintcdn.com/incredibuild-docs-migrated/QZKLvexHBXC-IhOu/images/linux/_shared/linux/linux_4/filters.jpg?fit=max\&auto=format\&n=QZKLvexHBXC-IhOu\&q=85\&s=cf7554f238ca18eeb48fb5c393b83b48)

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

   ![](https://mintcdn.com/incredibuild-docs-migrated/gcvhlEo33pnNz9db/images/linux/_shared/linux/linux_4/filters_build_groups.jpg?fit=max\&auto=format\&n=gcvhlEo33pnNz9db\&q=85\&s=a19962e6b090c9b7b8e3628470ef531e)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.