Deployment button is grayed out, blocking deployment.

Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.

Summary

The user expects to run a deployment step, but they can't click the deployment button.

Environment

Bitbucket Clod Pipelines deployments.

Diagnosis

The deployment button is grayed out, making it impossible to deploy.

Cause

Hovering the mouse over the deployment button makes it possible to see why it's blocked. Here is an example:

Hovering the mouse over the deployment button.

This indicates that the selected deployment environment has permissions set up that don't allow deployment from the develop branch.

This can be checked by navigating to the deployments option on the repository settings.

  1. On the left panel of the repository, click on Repository Settings.

  2. Under the Pipelines menu, click on Deployments.

There it's possible to see, between other options, what branches are allowed to deploy to this environment. In the example below, only a commit from the main branch can perform the deployment.

Single commit from the main branch can perform the deployment

Solution

To allow the deployment, the user needs to insert the branch that triggered the build on the "Branches allowed to deploy to <Environment>"list.

Updated on March 10, 2025

Still need help?

The Atlassian Community is here for you.