Jira Integration
The Space-Jira integration is designed for teams already using Jira for issue tracking. By configuring a connection to your existing Jira instance from Space, you can preview Jira issues in Space, link issues to commits and merge requests and update their status automatically. The integration involves installing the Space for Jira app to Jira and the Jira application to Space.
You can preview Jira issues mentioned in commit messages, code reviews, and merge requests. For example, if you mention an ID of a Jira issue, it'll transform to a link with a preview of the issue details:
![Unfurl a link to Jira issue in Space chat Unfurl a link to Jira issue in Space chat](https://resources.jetbrains.com/help/img/space/jiraIntegrationMentionIssueInChat2.png)
If you paste a whole link to a Jira issue, it will be unfurled:
![Mention Jira issue in Space chat Mention Jira issue in Space chat](https://resources.jetbrains.com/help/img/space/jiraIntegrationMentionIssueInChat.png)
If an issue ID is included in a commit message, a link to the commit or merge request will be automatically added to the corresponding issue in Jira. If the merge request is closed in Space (indicating the changes have been merged), the status of the related issue in Jira will be updated automatically.
To make this feature work, you should first map projects in Jira to their counterparts in Space.
![Linking Jira issues in commits in Space Linking Jira issues in commits in Space](https://resources.jetbrains.com/help/img/space/jiraIntegrationPullRequestLink2.png)
From the main menu choose Administration.
Scroll down the left sidebar menu and choose Featured Integrations.
Locate Jira Integration and click Enable.
Click Install app to Jira.
You'll be redirected to the Space app installation page in the Atlassian Marketplace.
Click Get it now.
If you're not logged in to your Jira instance (site), you'll be prompted to do so.
If you have more than one Jira sites, choose the one you want to integrate with Space and click Install app.
Confirm by clicking Get it now.
Space app will be installed to your Jira site.
Click Get started.
Select a Jira project to connect to Space and click Connect.
You will be redirected to the Space marketplace and prompted to install the Jira application into your Space organization.
If your JetBrains account is associated with more than one Space organization, make sure the correct organization is selected. You can also enter the address of the Space organization you want connected to Jira.
Click Install.
The Jira application will be installed in your Space organization, and you'll be taken to the project mapping dialog.
To link Space merge requests with Jira issues, you need to pare one of your Space projects with a particular Jira project.
Select the projects you want to link and click Connect.
You can map several project pares by clicking Add mapping.
tip
How does the mapping work?
For example, you have two projects in Space:
SPACE_PRJ_1
andSPACE_PRJ_2
. You mapSPACE_PRJ_1
to theJIRA_PRJ
project in Jira. If you make the'fix issue JIRA_PRJ-1234'
commit to the source code ofSPACE_PRJ_1
, the issueJIRA_PRJ-1234
in Jira will get a comment with a link to this commit. But if you make the same commit to the source code ofSPACE_PRJ_2
, the issueJIRA_PRJ-1234
in Jira will not be updated.Turn ON the switch to enable automatic issue status update on merge request completion.
You Jira integration is now set up and enabled. You can manage or disable it by navigating to Administration → Featured Integrations → Jira.
Thanks for your feedback!