Using the release page to check the progress of a version

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Screenshot: release page for a Jira version

Frequently asked questions

How do I find the 'Release' page for a version?

Go to your project > Releases > your desired version.

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:

Warning type Required development tool When will a warning display?
Open pull requests Bitbucket  An issue is done, but has an open pull request
Open reviews Crucible An issue is done, but has an open review
Unreviewed code Crucible, Bitbucket An issue is done, but its commits are not part of a pull request or code review
Failing builds Bamboo An issue is done, but is linked to a failing build

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'. Also, issue warnings are evaluated, depending on whether an issue is 'done' or not.

'To Do', 'In Progress', or 'Done' map to the status category of an issue's status. The status category of an issue is defined when you create a status. See Defining status field values (

Jira admin

 documentation) for more information.

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.

Why can't I see any warnings?

Warnings will only display on the Release page if:

  • Jira Software is connected to your Atlassian development tools, e.g. Bitbucket, Bamboo, Fisheye/Crucible; or GitHub. See Integrating with development tools for more information.

  • You have the 'View Development Tools' permission. See Permissions overview for more information.
  • Warnings are enabled. You can see which warnings are enabled by clicking the Manage warnings button.

    Screenshot: sample warnings that can be enabled


What information will I see in the 'Development' column?

The 'Development' column will display the commits, builds, and deployments related to an issue, provided that Jira Software is connected to the required development tool.

Information Required development tool Examples
Commits Bitbucket, GitHub, Fisheye 3 commits
Branches Bitbucket, GitHub 1 branch
Pull requests Bitbucket, GitHub 2 pull requests OPEN
Builds Bamboo or
Deployments Bamboo

Click any of the symbols to view a detailed dialog. The dialog will also provide links to the commits, builds, or deployments in the relevant development tool.

How do I release a version?

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. If Jira Software is connected to Bamboo, you can also choose to run a build when the version is released. See Deploying a release to know more about releasing a version.

Why does a 'Syncing' message display next to my version's status?

Jira Software regularly synchronizes issues with their related development data. However, to ensure that you are viewing the most recent data when you visit the Release page for the version, Jira Software will perform another check and synchronize any data that is not up to date.

Last modified on Jan 30, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.