JetBrains Space Help

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.

Key features

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

If you paste a whole link to a Jira issue, it will be unfurled:

Mention Jira issue in Space chat

Linking Jira issues in commits and merge requests

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

Set up Jira integration

  1. From the main menu choose Administration.

  2. Scroll down the left sidebar menu and choose Featured Integrations.

  3. Locate Jira Integration and click Enable.

  4. Click Install app to Jira.

    installAppToJira.png

    You'll be redirected to the Space app installation page in the Atlassian Marketplace.

  5. Click Get it now.

    If you're not logged in to your Jira instance (site), you'll be prompted to do so.

    JiraGetItNow.png
  6. If you have more than one Jira sites, choose the one you want to integrate with Space and click Install app.

    JiraInstallNow.png

    Confirm by clicking Get it now.

    Space app will be installed to your Jira site.

  7. Click Get started.

    JiraGetStarted.png
  8. Select a Jira project to connect to Space and click Connect.

    SelectJiraProject.png

    You will be redirected to the Space marketplace and prompted to install the Jira application into your Space organization.

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

    InstallJiraApp.png

    Click Install.

    The Jira application will be installed in your Space organization, and you'll be taken to the project mapping dialog.

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

    mapJiraProjects

    You can map several project pares by clicking Add mapping.

  11. Turn ON the switch to enable automatic issue status update on merge request completion.

  12. You Jira integration is now set up and enabled. You can manage or disable it by navigating to Administration → Featured Integrations → Jira.

Last modified: 31 May 2024