Git Integration for Jira Cloud Documentation

User Guide – GIJ Cloud

Introduction to GIJ

Thank you for using Git Integration for Jira! This guide explains how Git information displays in Jira through our application.

Have an idea for an improvement or want to request a specific feature? Submit a feature request on our Feature Request Board.

 

Jira Issue View

GIJ displays commits, branches, and pull/merge requests associated with a specific Jira issue. To link items to a Jira issue, include the Jira issue key in the commit message, branch name, or pull/merge request title.

See Linking Git Commits for more details.

Breakdown of information provided by GIJ in Jira issues:

Jira Issue View

Activity Stream – Git Commits

  1. Git Commits tab in the activity stream, organized by repository
  2. Individual commit with the developer who made it
  3. Commit message
  4. Commit line change summary by file
  5. Link to view code diff in Jira

Git Integration Panel

  1. Options to create a branch or pull request directly from a Jira issue
  2. Associated branches and pull requests with status icons

The Git Rollup Tab shows a summary of files, lines changed, and the developers who made changes associated with the Jira issue.

Git Rollup Tab

 

Linking Behavior

GIJ uses the Jira issue key to determine whether repository activity (commits, branches, pull/merge requests) links to any Jira items. Include the Jira issue key in the commit message, branch name, or pull request title. The key can appear anywhere in the message or name.

See Linking Git Commits to Jira Issues for more details.

Jira Issue Key
Commit Example
Pull request Example

 

Creating Branches

You can create branches directly from a Jira issue using GIJ.

To create a branch:

  1. Open the Git Integration panel from the right side of the Jira issue.
  2. Click Create branch.
Create Branch 1
  1. Select the repository to create the branch in.
  2. Select the source branch.
  3. Enter the branch name. Make sure the Jira issue key is included.
  4. Click Create branch.
Create Branch 2

A confirmation popup appears after the branch is created. Click the link to open the newly created branch directly.

 

Creating Pull/Merge Requests

You can create pull/merge requests directly from Jira using GIJ.

To create a pull/merge request:

  1. Open the Git Integration panel from the right side of the Jira issue.
  2. Click Create Pull Request or Create Merge Request.
Create PR 1
  1. Select the repository.
  2. Select the source and target branches.
  3. Verify the title contains the Jira issue key.
  4. Click Create pull/merge request.
Create PR 2

A confirmation popup appears after the pull/merge request is created. Click the link to open it directly.

 

GIJ User Settings

GIJ lets you manage your connected apps, default repository, default branch, and personal access tokens through the GIJ User Settings page.

To access User Settings:

  1. Click your Jira profile picture icon.
  2. Select Git Integration: User Settings.
User-Settings

Connected Apps

Enable or disable the visibility of GitKraken and GitLens icons in Jira issues. These icons let you open specific Git items in the respective application directly from the issue.

Connected Apps
Connected Apps - icons

Default Repository

Set a default repository on a per-project basis.

Default-repo

Default Branch

Set a default branch for a specific repository, configured by Jira project.

Default-Branch

Personal Access Tokens

Manage the personal access tokens used to authenticate your requests to create branches and pull requests directly from Jira. You need to provide a token for each integration.

You can enter an existing personal access token or click the link to create a new token. The link takes you directly to the token creation page for that Git service.

See Creating Personal Access Tokens for detailed instructions.

PAT

 

Last updated: December 2025

Have feedback about this article? Did we miss something? Let us know!
On this page