What is the deployments feature?

Jira provides a 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.

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 work item keys in commits, branch names, and pull requests, to start linking code and deployment information to Jira. Read more about setting up your deployment integration and referencing work items in your development work.

View deployment information in Jira

Once you set up a deployment integration, the Development page will show all the deployments linked to your work items, displayed in a table. Select Deployments in the Related work section to view all the production deployments linked to work items in your space, each deployment's status, and the last deploy time.

As well as tracking the status of work, the Development 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 work items through the deployment pipeline, from the first commit until the code is deployed to production.

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

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

• Your Jira board - displays an icon when a deployment is linked to a work item. 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 work items in your version.

• In Jira Query Language (JQL) - search your space for deployment information using JQL (for example, search for all the work items that have been deployed to production). View more about JQL.

• In automations - set up automation flows to perform certain actions based on the deployment data linked to your work items (for example, send a slack message when a work item is deployed to production). More about DevOps automation triggers.