[Other doc versions]
[Doc downloads]
When Stash is integrated with Atlassian JIRA, you can:
The Commits tab for a Stash project, showing JIRA issues
Stash integrates with JIRA by means of an 'application link'. You can set up application links either:
Stash integration with JIRA may require an upgraded version of the FishEye plugin in JIRA. See JIRA compatibility for details about upgrading the JIRA FishEye plugin, and for download links to the upgraded plugin versions.
On this page:
To link Stash to a JIRA server:
Go to the Configure Application Links screen in Stash (you need to be a Stash administrator):
Click Add Application Link:
Complete the application link wizard to connect Stash to your JIRA server. It is recommended that you make use of the automatic link-back from JIRA to Stash (you'll need JIRA system administrator global permission for that).
More detailed information about application links can be found on Configuring Application Links.
You're finished! No other configuration is required. Your JIRA issues will appear in the changesets and commit lists in Stash. On the JIRA side, the commits associated with a specific issue will now appear in the issue's Source tab.
We have tried to make the integration of JIRA with Stash as straightforward as possible. However, we are aware of the following issues:
We apologise for the inconvenience. You can watch the 2 issues below to keep track of our progress:
There are a few scenarios where the integration of Stash with JIRA can produce an error:
This can result if authentication for the application link has not been set up.
If you don't have permission to access the JIRA project then Stash is unable to display issues.
Stash doesn't check for invalid issue keys, such as UTF-8. An error will result if Stash tries to connect to an issue that doesn't exist.
Stash can integrate with JIRA 4.3.x, or later. Some features require higher versions of JIRA to function properly. See JIRA compatibility for details.