• Products
  • Documentation
  • Resources

What is the deployments feature?

The deployments feature provides a timeline view of your deployment information in Jira when you connect a deployment tool like Bitbucket, GitHub, GitLab, Jenkins, Azure DevOps, or any other supported tool. This allows everyone on the team to track work items as they move through the deployment pipeline and see which features have deployed to which environment.

deployments

To use the deployments feature, you must enable deployments in your Jira project settings and connect a deployment tool to your Jira site. Learn more about setting up your deployment integration.

Enable or disable the deployments feature

You must be a project admin to enable and disable features on a project. You must also have the permission View Development Tools to enable the deployments feature.

To enable or disable the deployments feature:

  1. Log in to Jira and select Project settings in your project menu.

  2. Select Features.

  3. Use the Deployments toggle to turn the feature on or off.

Connect your deployment tool to Jira

To send deployment information to Jira, you must connect a development tool like Bitbucket, GitHub, GitLab, Jenkins, Azure DevOps, or any of the tools available on the Atlassian Marketplace. Your team must then reference issue keys in commits, branch names, and pull requests, to start linking code and deployment information to Jira. Learn more about setting up your deployment integration and referencing issues in your development work.

View deployment information in Jira

Once you set up a deployment integration, the Deployments page will show all the deployments linked to your issues, displayed over a timescale. You can filter by environment, version, epic, and issue type, or change the date range.

As well as tracking the status of work, the Deployments page also tracks your team’s performance. The deployment frequency insight tells you how often your team deploys to production, and tracks your team’s average weekly deployments over a 12-week range. The cycle time insight measures how long it takes your team to ship issues through the deployment pipeline, from the first commit until the code is deployed to production. It shows your median cycle time per week, and calculates your overall median from the last 12 weeks. Learn more about deployment insights.

Deployment frequency insight card showing average deployments per week

Outside the Deployments page, Jira will also show deployment information in the following places:

  • On Jira issues - the development panel updates automatically to show deployment status and environment details.

  • Your Jira board - displays an icon when a deployment is linked to an issue. Hover over the icon to view the details of the deployment.

  • In the Releases hub - if you’re using releases and versions to organize your work in Jira, the releases feature shows deployment information for all the issues in your version.

  • In JQL - search your project for deployment information using JQL (for example, search for all the issues that have been deployed to production). Learn more about JQL.

  • In automations - set up automation rules to perform certain actions based on the deployment data linked to your issues (for example, send a slack message when an issue is deployed to production). Learn more about DevOps automation triggers.

Still need help?

The Atlassian Community is here for you.