# Stash Latest (2.9) : JIRA integration

Added by pwatson , edited by pwatson on Nov 18, 2013
When Stash is integrated with Atlassian JIRA , you and your team get all these benefits:

- Create Git branches from within JIRA and JIRA Agile.
- Transition JIRA issues from within Stash.
- Use JIRA issue keys in Stash markdown.
- See the details for JIRA issues in Stash.
- See the JIRA issues related to Stash commits and pull requests.
- See all the files commited for the issue (on the JIRA Source tab).
- From JIRA, click through to see a changed file, or the full commit, in Stash.

You can also use JIRA for delegated management of your Stash users. See External user directories.

Your Stash administrator needs to set up linking with JIRA before you'll see these work.

##### Related pages:

- Linking Stash with JIRA
- JIRA FishEye-Stash Plugin compatibility
- Connecting to JIRA for user management

You can start creating a branch from a JIRA issue. This gives you a faster workflow from picking an issue to starting coding.

Stash will suggest the branch type and branch name, based on the JIRA issue type and summary – you can change these, of course.

You can easily transition a JIRA issue from within Stash. For example, when creating a pull request you may want to transition the issue into review. Click on a linked JIRA issue anywhere in Stash to see a dialog with the available workflow steps:

Click on a step and complete the fields as required. If there are custom fields that are unsupported by Stash, just click Edit this field in JIRA to transition the issue directly in JIRA.

Stash can link to more than one JIRA server at a time, so different teams can work with their own projects in different JIRA instances, or a single team can link to issues across multiple JIRA servers.

When you mention a JIRA issue key in Stash, for example in a pull request description or a comment, the key gets automatically linked:

Click on the linked key to see details for the issue.

Click a linked issue key anywhere in Stash to see the details of that issue in a dialog. And you can just click the issue key at the top of the dialog to go straight to the issue in JIRA:

Stash recognises JIRA issue keys in commit messages, and displays the keys as links on the Commits tabs for both the repository and pull requests:

Click on the linked key to see details for the issue.

In JIRA, you can see details for a commit made in Stash. And you can click through to go straight to the commit in Stash:

## Attachments:

skitched-20120316-150747.jpg (image/jpeg)
skitched-20120327-161202.jpg (image/jpeg)
image2012-3-27 16:58:27.png (image/png)
image2012-3-27 16:59:5.png (image/png)
image2012-3-27 17:3:50.png (image/png)
image2012-3-27 17:3:50.png (image/png)
image2012-3-27 17:18:25.png (image/png)
image2012-3-27 17:18:25.png (image/png)
image2012-3-27 17:21:32.png (image/png)
image2012-3-27 17:21:32.png (image/png)
STASH10_JIRAs in commits.png (image/png)
Stash_1_1_add_application_link.png (image/png)
Stash_1_1_app_links.png (image/png)
Stash_1_1_app_links.png (image/png)
Stash_1_1_app_links.png (image/png)
Stash_1_1_add_application_link.png (image/png)
STASH10_JIRAs in commits.png (image/png)
image2012-3-27 17:21:32.png (image/png)
image2012-3-27 17:18:25.png (image/png)
image2012-3-27 17:3:50.png (image/png)
image2012-3-27 16:59:5.png (image/png)
image2012-3-27 16:58:27.png (image/png)
skitched-20120327-161202.jpg (image/jpeg)
skitched-20120316-150747.jpg (image/jpeg)
Stash12_app_link.png (image/png)
Stash12_add_app_link.png (image/png)
Stash12_add_app_link.png (image/png)
Stash12_app_link.png (image/png)
skitched-20120316-150747.jpg (image/jpeg)
skitched-20120327-161202.jpg (image/jpeg)
image2012-3-27 16:58:27.png (image/png)
image2012-3-27 16:59:5.png (image/png)
image2012-3-27 17:3:50.png (image/png)
image2012-3-27 17:18:25.png (image/png)
image2012-3-27 17:21:32.png (image/png)
STASH10_JIRAs in commits.png (image/png)
Stash_1_1_add_application_link.png (image/png)
Stash_1_1_app_links.png (image/png)
Stash_1_1_app_links.png (image/png)
Stash_1_1_add_application_link.png (image/png)
STASH10_JIRAs in commits.png (image/png)
image2012-3-27 17:21:32.png (image/png)
image2012-3-27 17:18:25.png (image/png)
image2012-3-27 17:3:50.png (image/png)
image2012-3-27 16:59:5.png (image/png)
image2012-3-27 16:58:27.png (image/png)
skitched-20120327-161202.jpg (image/jpeg)
skitched-20120316-150747.jpg (image/jpeg)
Stash12_app_link.png (image/png)
Stash12_add_app_link.png (image/png)
STASH24_add_application_link.png (image/png)
Stash12_add_app_link.png (image/png)
Stash12_app_link.png (image/png)
skitched-20120316-150747.jpg (image/jpeg)
skitched-20120327-161202.jpg (image/jpeg)
image2012-3-27 16:58:27.png (image/png)
image2012-3-27 16:59:5.png (image/png)
image2012-3-27 17:3:50.png (image/png)
image2012-3-27 17:18:25.png (image/png)
image2012-3-27 17:21:32.png (image/png)
STASH10_JIRAs in commits.png (image/png)
Stash_1_1_add_application_link.png (image/png)
Stash_1_1_app_links.png (image/png)
STASH24_add_application_link.png (image/png)
STASH24_add_application_link.png (image/png)
Stash_1_1_app_links.png (image/png)
Stash_1_1_add_application_link.png (image/png)
STASH10_JIRAs in commits.png (image/png)
image2012-3-27 17:21:32.png (image/png)
image2012-3-27 17:18:25.png (image/png)
image2012-3-27 17:3:50.png (image/png)
image2012-3-27 16:59:5.png (image/png)
image2012-3-27 16:58:27.png (image/png)
skitched-20120327-161202.jpg (image/jpeg)
skitched-20120316-150747.jpg (image/jpeg)
Stash12_app_link.png (image/png)
Stash12_add_app_link.png (image/png)
Stash27_JIRA_issue_markup.png (image/png)
Stash27_detect_issue_keys.png (image/png)
Stash27_issue_details.png (image/png)
Stash27_issue_in_message.png (image/png)
Stash27_issue_in_message.png (image/png)
Stash27_issue_key.png (image/png)
Stash27_issue_details.png (image/png)
Stash27_issue_details.png (image/png)
Stash27_issue_details.png (image/png)
Stash27_close_JIRA.png (image/png)
Stash27_close_JIRA.png (image/png)
Stash27_steps.png (image/png)
Stash27_commits_in_JIRA.png (image/png)
Stash27_trans_issue.png (image/png)
feedback.png (image/png)
STASH28_create_branch_jira.png (image/png)
feedback_1_min.png (image/png)