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 typeRequired development toolWhen will a warning display?
Open pull requestsBitbucket An issue is done, but has an open pull request
Open reviewsCrucibleAn issue is done, but has an open review
Unreviewed codeCrucible, BitbucketAn issue is done, but its commits are not part of a pull request or code review
Failing buildsBambooAn 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.

InformationRequired development toolExamples
CommitsBitbucket, GitHub, Fisheye3 commits
BranchesBitbucket, GitHub1 branch
Pull requestsBitbucket, GitHub2 pull requests OPEN
BuildsBamboo or
DeploymentsBamboo

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.