• Products
  • Documentation
  • Resources

Jira Automation docs have moved

All content related to Jira Cloud Automation, previously under the Automate your Jira processes and workflows section, have moved to the new Cloud Automation docs.

Go to Cloud Automation documentation | Why did we do this?

Use the release page to check the progress of a version

Versions represent points in time for your project. They can be used to schedule how features are rolled out to your customers, or as a way to organize work that has been completed for the project.

In Jira Software, versions are managed via the Releases feature.

How do I find the release page for a version?

Go to your project > Releases > your desired version.

A screenshot of the release hub showing the status of the release, issues in the version, and issue progress.

What statuses are considered to be 'To Do', 'In Progress', and 'Done'?

On the release page for a version, issues are grouped into tabs, depending on whether they are 'To Do', 'In Progress', or 'Done'.

An issue will appear under 'To Do', 'In Progress', or 'Done' according to the issue’s status and status category. For example, the status 'Open' may have its status category set as 'To Do'. Therefore, it will display on the release page in the 'Issues to do' tab. Learn more about issue statuses in Jira and how to configure them.

What warnings are shown on the 'Warnings' tab?

Issue warnings tell you when your issue data is potentially out of sync with your development data. Depending on which development tools are connected to Jira Software, the release page will display the following warnings:

  • Open pull requests - An issue is done, but has an open pull request.

  • Unreviewed code - An issue is done, but its commits are not part of a pull request or code review.

  • Failing builds - An issue is done, but is linked to a failing build.

  • Open reviews - An issue is done, but has open reviews (you’ll only see this warning type if you’re using the Fisheye-Crucible integration with Jira Software).

Why can't I see any warnings?

Warnings will only display on the release page if:

Manage Warnings screen for releases. Enable warnings for open pull requests, open reviews, unreviewed code and failed builds.

What development information will I see on the release page?

A sample release hub with 7 columns: priority, issue type, project key, summary, assignee, status, and development panel.

The release page will display the commits, branches, pull requests, builds, and deployments related to each issue, provided that:

  • Jira Software is connected to your development tools, and

  • your team includes issue keys in their branch names, commit messages, and pull requests.

Commits, branches, and pull requests

If you’ve connected an SCM tool like Bitbucket or GitHub, you’ll see the number of commits, branches, and pull requests associated with each issue in the Development column. We’ll also show the pull request status (e.g. OPEN, MERGED, DECLINED). Click on a piece of dev info to view a detailed dialog with links to the commits, branches, or pull requests in your SCM tool.

Builds

If you’ve connected a build tool like Bitbucket, GitHub, or GitLab, you’ll see the build status for each issue in your version in the Builds column. We’ll show an icon to indicate whether the build was successful, failed, or unknown. Click on a build icon to view a detailed dialog with links to the associated pipelines in your build tool.

Deployments

If you’ve connected a CI/CD tool like Bitbucket Pipelines, GitHub, GitLab, or Jenkins, you’ll see the deployment status of each issue in your version in the Deployments column. We'll show an icon to indicate whether an issue has been deployed successfully and a label to tell you what environment it’s been deployed to. Click on a deployment status to view a detailed dialog with links to the associated pipelines in your CI/CD tool.

How do I release a version?

To release a version, go to your project > Releases > your desired version, and select ‘Release’. Releasing the version will mark it as 'Released' in Jira Software. You will have the option of setting a release date and moving any incomplete issues to another version.

Additional Help