---
title: "What should I do when encountering a missing build branch error?"
date: "2025-05-27T10:14:18+00:00"
summary: "Troubleshoot missing build branch errors in Code Studio with step-by-step solutions for developers and DevOps teams."
image:
type: "article"
url: "/acquia-cloud-platform/add-ons/code-studio/help/69346-what-should-i-do-when-encountering-missing-build-branch-error"
id: "fbaff10b-e0e5-4ddd-87d1-08ad34a264b7"
---

**Description**

**Build stage**

**Job**

**Error message**

**Category**

**Responsibility**

[Deploy](https://docs.acquia.com/acquia-cloud-platform/add-ons/code-studio/docs/customizing-code-studio/drupal-auto-devops/autodevops-jobs#section-deploy-drupal-stage)

Create Acquia CDE

`The build branch '<BRANCH_NAME>' is missing from Acquia Cloud Platform`

Application

Customer

**Potential cause**

This error occurs during merge requests if one of the following is true:

*   The `ACQUIA_JOBS_CREATE_BRANCH_ARTIFACT` environment variable is not set to `true`. The branch artifact must be created so that it can be pushed to [Cloud Platform](https://docs.acquia.com/acquia-cloud-platform).
*   The source branch exists on a fork instead of the main repository.

**Solution**

*   To create the branch artifact:
    1.  Add the `ACQUIA_JOBS_CREATE_BRANCH_ARTIFACT` environment variable to your project.
    2.  Set the value of `ACQUIA_JOBS_CREATE_BRANCH_ARTIFACT` to `true`.
        
        For more information, see [Adding environment variables](https://docs.acquia.com/acquia-cloud-platform/add-ons/code-studio/customizing-code-studio/default-code-studio-pipeline/environment-variables#section-adding-environment-variables).
        
*   If the source branch does not exist in the main repository:
    1.  Push the source branch to the main Code Studio project repository.
    2.  Create the merge request without using a forked repository.
*   Before you create a merge request using the target branch:
    
    1.  Ensure that the target branch successfully passes a Code Studio pipeline.
    2.  Deploy the target branch to Cloud Platform.