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|
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.