Navigate to Apps in the Jira navigation bar and select Explore more apps. In the search field, type GitHub for Jira and proceed with the installation by clicking Get App → Get it now.
Once the installation is successful, click the Get started button to integrate Jira with your GitHub repository. Click Continue on the initial Connect GitHub to Jira page.
Next, select GitHub Cloud if your repository is hosted on GitHub. Then, click the Next button.
If this is your first time integrating Jira with GitHub, you will be prompted to log in and authorize the connection. Once authorized, select the repositories you want to integrate with Jira. You can choose multiple repositories by clicking Select organization / another organization.
The organization can either be from a personal GitHub account or a GitHub Organization (only accessible by administrators).
After selecting the organization, choose the specific repositories you want to integrate. In this example, we'll select only one repository, test-jira. Then, click Install.
If the installation is successful, the integration page will look like this:
On the right side of the Jira Issue details, there will be a Development section used for tracking branches, commits, and pull requests from GitHub.
To ensure branches and commits are reflected in Jira, Jira enforces the following rules:
-
Branch names must follow Jira’s naming convention, which is derived from the issue number + the issue title. For example, for the Subtask issue KAN-3 Design Task Creation UI, the branch name should be KAN-3-design-task-creation-ui or follow the template provided by Jira.
-
To ensure commits are tracked in Jira, the commit message must include the issue number. For example, for issue KAN-3, the commit message should include KAN-3.
