---
title: Builds
slug: suite-documentation/builds
docTags: 
createdAt: 2026-06-10T12:07:00.344Z
---

## Overview

The Build system is a new approach to the execution process that separates project code preparation from Plan execution.

Instead of relying on a forced system process that prepares or rebuilds the project code during every scenario execution, users can create a Build in advance and assign it to a Plan, so each scenario execution uses the selected prebuilt version of the project. **The main purpose of this is to speed up test execution by separating the build process from the execution flow.**

Builds are managed at the **Project** level and are created based on the selected **branch**. This means each Build is connected to the project code from a particular branch, such as main, develop, release, or any other branch available in the user’s repository.

Each project can have up to **6 Builds **(this can be changed for on-prem users). These Builds can belong to the same branch or different branches, depending on the user’s testing needs.

For example:

- A user can create multiple Builds from the same branch when the branch code is updated.
- A user can create separate Builds for different branches, such as one Build for main and another Build for develop.
- Different Plans under the same Project can use different Builds, allowing users to execute different prepared versions of the test code.

This structure gives users more control over which version of the project code is used during Plan execution. It is especially useful when different Plans are related to different branches, or when users want to avoid rebuilding the project during every execution.

:::hint{type="info"}
**Previous Structure (before builds)**

Before Builds were introduced, the system prepared and built the project code separately for each scenario execution within a Plan.

Every scenario execution included both:

- Preparing and building the project code
- Running the test scenario

Repeating these steps for every scenario increased the overall execution time, especially for projects with lengthy builds or dependency preparation.

This impact was particularly noticeable in **One-by-One** execution mode, where scenarios run independently. Each scenario required its own preparation and build steps, resulting in **longer waiting times** before and between scenarios.
:::

## How Builds Work

![](https://api.archbee.com/api/optimize/RP8RoPxhAp8jZDWs8V_wZ/9ni4StqHreP7dTI36yU_q_image.png)

Builds are managed at the project and branch level.

A user can create a Build for a selected branch of a project. After the Build is created successfully, it becomes available for selection in Plans that belong to the same project.

The general flow is:

1. Open the relevant project.
2. Go to the Builds section.
3. Select a branch.
4. Create a Build for that branch.
5. The Build becomes available for Plan configuration.
6. Select the Build in the Plan.
7. Run the Plan using the selected Build.

Builds complete project preparation before the Plan run starts, reducing preparation time during execution, providing greater control over the execution setup, and reducing reliance on the default preparation flow.

## Create Build

Users can create a Build from the project detail page.

![](https://api.archbee.com/api/optimize/RP8RoPxhAp8jZDWs8V_wZ/RNpEiBEeVmYUp7DvgcLKN_image.png)

To create a Build:

1. Open the related Project.
2. Go to the **Builds** tab.
3. Enter build's name
4. Select the branch
5. Select the commit for which the Build will be created.
6. Click **Create Build**.
7. Wait until the Build process is completed.
8. Once completed successfully, it can be selected in the Plan configuration for execution

Each Build is created for a specific project and branch.

Users should create a new Build when:

- The user wants to run a Plan with the latest prepared version of the project (latest commit)
- A new branch needs to be tested
- A specific branch version should be used in a Plan

## Using a Build in Plan

After a Build is created, it can be selected in the Plan configuration.

![](https://api.archbee.com/api/optimize/RP8RoPxhAp8jZDWs8V_wZ/u1LSMTkNkImh1qGpp0ubt_image.png)

To use a Build in a Plan:

1. Open the related Plan.
2. Go to the Plan edit page.
3. Select the Build that should be used by the Plan.
4. Save the Plan.
5. Run the Plan.

![](https://api.archbee.com/api/optimize/RP8RoPxhAp8jZDWs8V_wZ/douOwvx4_sOyBFjyvvGQ__image.png)

When the Plan is executed, the selected Build will be used during the execution.

This allows users to decide which prepared project version should be used for each Plan.

For example, if there are two Plans created from different branches, each Plan can be configured with the correct Build for its related branch. This prevents Plans from using an incorrect Build during execution.

:::hint{type="warning"}
The selected Build should belong to the same branch as the scenarios included in the Plan. Since a Build is generated from a specific branch, using it with scenarios from a different branch may cause version differences or unexpected execution behavior. To ensure a consistent execution, always select a Build that matches the branch used by the Plan scenarios.
:::

## Assigning Builds to Plans

You can also assign a successful build to one or more plans directly from the **Builds** page. Assigned plans use the selected prepared build during execution.

::Image[]{src="https://api.archbee.com/api/optimize/RP8RoPxhAp8jZDWs8V_wZ/MOmCC5KtnSWklsTXDuRci_image.png" size="50" isUploading="false" width="2360" height="916" darkWidth="2360" darkHeight="916" showCaption="false"}

To assign a build:

1. Click the **Assign Build to Plans** icon in the build’s **Action** column.
2. Select the plans that should use the build, or use **Select all**.
3. Click **Assign** to save your selection.

Only plans compatible with the build’s branch can use the build. An assigned build cannot be deleted until all plan associations are removed.

## Important Notes

- Builds are created and managed at the **Project** level.
- Each Project can have up to **6 Builds **(this can be changed for on-prem users).
- Builds are created based on the selected **branch**. A Build represents the prepared version of the project code from that branch.
- A Build must be created successfully before it can be assigned to a Plan.
- A Plan cannot be executed without selecting a Build. Users must assign a Build to the Plan before starting execution.
- Plans can only use Builds that belong to the same Project.
- Different Plans under the same Project can use different Builds. This is useful when Plans are related to different branches or different prepared versions of the project code.
- If the project code changes, it is advised that users should create a new Build to make sure the latest code is used during execution.
- If a Build is associated with one or more Plans, it cannot be deleted. To delete a Build, users must first remove all Plan associations related to that Build.