By moving to the cloud engineering teams can accelerate innovation and scale resources across an organization. The ease of access and reduced infrastructure costs that comes with moving to the cloud is a direct result of using a platform that easily integrates your data and keeps it secure yet accessible. Gitlab.com, the cloud (SAAS) platform for GitLab, modernizes data platforms to leverage new applications and advances end-to-end software delivery. GitLab partners with other best-in-class cloud companies so your teams can use tools that best align with your team's DevOps ecosystem. Application development requires speed and iteration, making seamless collaboration a necessity to deliver real business value. GitLab embraces connecting all phases of the software development lifecycle (SDLC) in a DevOps ecosystem that fuels visibility, collaboration, and velocity.

How to use GitLab with Atlassian's Jira

We know that many companies have been using Jira for project management, and have existing data and business processes built into their instance. For some of these customers, this means it can be difficult and cost-prohibitive to move off of Jira. We believe that people (and tools) work better when they're all in one place, so to serve these customers, we built a seamless integration between GitLab and Jira. By using the GitLab for Jira app in the Atlassian Marketplace, you can integrate GitLab.com and Jira Cloud harmoniously.

Here's a short list of what you can do when integrating GitLab with Jira:

How to configure the integration

There are two methods for configuring the integration. The Jira DVCS connector, and the method we describe in this blog post. The DVCS connector updates data only once per hour, while our method syncs data in real time. We recommend using our method for this reason, but if you are not using both of these environments then use the Jira DVCS connector instead.

Arrow pointing to "get it now button" on GitLab on Atlassian Marketplace App Click the yellow button to download the app.

GitLab on Atlassian Marketplace App Click the "Get started button".

GitLab for Jira Configuration Add a namespace.

After a namespace is added, all of the future commits, branches, and merge requests within all projects under that namespace will be synced to Jira. At the moment, past data cannot be synced.

For more information, see the documentation.

Troubleshooting GitLab for Jira

The GitLab for Jira App uses an iframe to add namespaces on the settings page. Some browsers block cross-site cookies which can lead to a message saying that the user needs to log on to GitLab.com even though the user is already logged in: "You need to sign in or sign up before continuing."

In this situation, we recommend using Firefox, Google Chrome or enabling cross-site cookies in your browser.

Limitations of GitLab for Jira

This integration is currently not supported on GitLab instances under a relative URL (for example, http://yourcompanyname.com/gitlab).

How to use GitLab for Jira

After the integrating GitLab and Jira, you can:

GitLab for Jira Setup In this image, you can see that this Jira issue has four stages: Backlog, selected for development, in progress, and done.

View of Jira Transitions There are multiple Jira transition options.

View branches, commits and merge requests in your jira issue View branches, commits, and merge requests in your Jira issue.

Deep Dive into your GitLab commits How to take a look at your GitLab commits.

Deep Dive into your GitLab branches Take a deep Dive into your GitLab merge requests.

For more information on using Jira Smart Commits to track time against an issue, specify an issue transition, or add a custom comment, see the Atlassian page using Smart Commits.

Watch and learn

More of a video person? For a walkthrough of the integration with GitLab for Jira, watch and learn how to configure GitLab Jira Integration using Marketplace App.

GitLab helps teams ship software faster with technology integration options, such as the integration with Jira, that automate tasks, provide visibility into development progress and the greater end-to-end software lifecycle. We recognize that many companies use Jira for Agile project management and our seamless integration brings Jira together with GitLab.

Cover image by Mikołaj Idziak on Unsplash.

Try all GitLab features - free for 30 days

GitLab is more than just source code management or CI/CD. It is a full software development lifecycle & DevOps tool in a single application.

Try GitLab Free
Git is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license

Try GitLab risk-free for 30 days.

No credit card required. Have questions? Contact us.

Gitlab x icon svg