How to connect GitLab to your Jira Cloud Instance - Actonic – Unfolding your potential

How to connect GitLab to your Jira Cloud Instance


GitLab is an extremely effective version control system used primarily for software and web development projects. This Version Control System (VCS) helps you to work efficiently and agilely on your projects, because it allows you to work on a project with several developers at the same time.

Users of the project management software Jira by Atlassian can benefit greatly from GitLab. The two agile tools can be combined and simplify your development process thereby immensely. Once you have integrated your GitLab project into your Jira instance, you can automatically identify and compare activities between the GitLab project and all your projects in Jira.

In our article, we explain how to connect GitLab with Jira and give you a practical step-by-step guide. We’ll show you all needed steps in Jira Cloud and GitLab.

A practical guide for an effective connection of the two agile tools


A) You have an existing GitLab instance and the administrator permissions for it.

B) You have an existing Jira Cloud instance and the administrator permissions for it.

Connect GitLab with Jira Cloud – Here’s what to do in Jira Cloud

Install the GitLab app in Jira:

  1. Go to your settings in Jira Cloud.
  2. Click on “Find new apps“.
  3. Enter “GitLab“ in the search field.
  4. Click on “ for Jira Cloud“.
  5. Install the app on your instance.

Start the GitLab app in Jira

  1. Go to “Manage apps“.
  2. Click the down arrow in “GitLab for Jira (“ to see the app details.
  3. Click on “Get started“.

Optional: Check if your loose connection to GitLab is working

If you are logged in as “@ExampleUsername“, your connection to GitLab is available.

If not:

  1. Click on “Add namespace“ on the page shown in the following screenshot.
  2. Link the corresponding GitLab instance you want to connect by clicking “Link“.

The connection to the Jira Cloud page is now complete.

Connect GitLab with Jira Cloud – Here’s what to do in GitLap

  1. Visit your GitLab instance and check if you are in the right project. If not, go to “Menu“ at the top.
  2. Click on “Settings“.
  3. Click on “Integrations“.
  4. Select the Jira integration and click on “Jira“.

Optional: Change the default settings to your custom solution

After completing step 4 and clicking on “Jira“, you will get the view shown in the screenshot below. Fill in the fields marked in the screenshot as follows:

  1. Web URL: Enter the URL of your Jira Cloud instance. Use the format: https:// <your instance> .atlassian. net.
  2. Username or e-mail: Enter your e-mail address.
  3. Enter new password or API token: Fill in your API token. How to get an API token is explained below in the following section.
  4. Test settings Button: Test your settings with the “Test settings“ button. (This step is optional).
  5. Save changes Button: Save your changes by clicking on this button after you have inserted all credentials.

The connection on the GitLab page is now complete.

For 3. Enter new password or API token – How to get your API token

  1. Visit id. atlassian . com / manage-profile/security/api-tokens.
  2. Click on “Create API token“.
  3. Label the API token as you like (for example: “Git token“).
  4. Copy your new token. Caution: After closing this window, you will not be able to view it again and may have to create a new token.

Results & Features

If you use GitLab and Jira together, you can view the features that GitLab has on your Jira issues in Jira under the newly created “Development“ field.

This field shows you all the information about your GitLab project that you recently activated (see information in the screenshot below).

Your Possibilities through GitHub References for Jira – A Quick Overview

Use the issue key and “#“ to include references to Jira in your GitLab.

Attention: To do this, the correct options must be set to enable several actions. See the second screenshot under “How to do it on GitLab“.

Two examples

Commit Message



XTP-13 #comment I am a comment

“I am a comment“ will also appear in the Jira issue as a comment in the bottom part.

XTP-13 #in-progress

XTP-13 will be moved from workflow status “To Do“ into “In Progress“.

Any more questions? Feel free to contact us for any questions you have about connecting GitLab to Jira Cloud and any other Atlassian topics. Write to us quickly and easily via the contact box below!

Want to
know more?

Contact us to talk to our experts and have all your questions answered.

free offer

How useful was this post?

Click on a star to rate it!

Average rating 5 / 5. Vote count: 2

No votes so far! Be the first to rate this post.