Jira integrations

GitLab can be integrated with Jira.

Issues are a tool for discussing ideas, and planning and tracking work. However, your organization may already use Jira for these purposes, with extensive, established data and business processes they rely on.

Although you can migrate your Jira issues and work exclusively in GitLab, you can also continue to use Jira by using the GitLab Jira integrations.

Integration types

There are two different Jira integrations that allow different types of cross-referencing between GitLab activity and Jira issues, with additional features:

Jira development panel integration configuration depends on whether:

  • You’re using GitLab.com or a self-managed GitLab instance.
  • You’re using Jira on Atlassian cloud or on your own server.
You use Jira on: For the Jira development panel integration, GitLab.com customers need: For the Jira development panel integration, GitLab self-managed customers need:
Atlassian cloud The GitLab.com for Jira Cloud application installed from the Atlassian Marketplace. The GitLab.com for Jira Cloud, using a workaround process. See a relevant issue for more information.
Your own server The Jira DVCS connector. The Jira DVCS connector.
noteDVCS means distributed version control system.

Feature comparison

The integration to use depends on the capabilities your require. You can install both at the same time.

Capability Jira integration Jira Development Panel integration
Mention of Jira issue ID in GitLab is automatically linked to that issue Yes No
Mention of Jira issue ID in GitLab issue/MR is reflected in the Jira issue Yes, as a Jira comment with the GitLab issue/MR title and a link back to it. Its first mention also adds the GitLab page to the Jira issue under “Web links”. Yes, in the issue’s Development panel
Mention of Jira issue ID in GitLab commit message is reflected in the issue Yes. The entire commit message is added to the Jira issue as a comment and under “Web links”, each with a link back to the commit in GitLab. Yes, in the issue’s Development panel and optionally with a custom comment on the Jira issue using Jira Smart Commits.
Mention of Jira issue ID in GitLab branch names is reflected in Jira issue No Yes, in the issue’s Development panel
Record Jira time tracking information against an issue No Yes. Time can be specified via Jira Smart Commits.
Transition or close a Jira issue with a Git commit or merge request Yes. Only a single transition type, typically configured to close the issue by setting it to Done. Yes. Transition to any state using Jira Smart Commits.
Display a list of Jira issues Yes No
Create a Jira issue from a vulnerability or finding Yes No