how to link jira with github

How to Link Jira with GitHub

By Kevin Thompson
AD

If you're working with development teams, you've probably found yourself in a situation where you need to track issues and manage projects in Jira, while your development team is pushing code to GitHub. While both tools excel at their respective tasks, integrating Jira with GitHub can significantly streamline your workflow and improve collaboration. This article will guide you through the process of linking Jira with GitHub.

Before we dive into the integration process, let's ensure you have the necessary permissions and access to both Jira and GitHub. You'll need to be an admin or have the necessary permissions to set up the integration. Also, ensure your Jira instance is connected to the internet and allowlists the GitHub domains for seamless integration.

Setting Up the Jira-GitHub Integration

The first step is to set up the integration between your Jira instance and your GitHub organization or repository. This will allow Jira to access and interact with your GitHub data.

AD
How to Get Started With GitHub in 2026 and Build Real Projects Fast
How to Get Started With GitHub in 2026 and Build Real Projects Fast
Discover the Power of GitHub: Your Gateway to Open Source Code 💻
Discover the Power of GitHub: Your Gateway to Open Source Code 💻
Jira Keyboard shortcuts
Jira Keyboard shortcuts

To set up the integration, you'll need to generate a GitHub Personal Access Token (PAT) with the 'repo' scope. Here's how:

Generating a GitHub Personal Access Token

  1. Log in to your GitHub account.
  2. Click on your profile picture, then click on "Settings".
  3. Select "Developer settings" from the left sidebar, then click on "Personal access tokens".
  4. Click on "Generate new token".
  5. Give your token a description, then check the 'repo' box to grant it access to your repositories.
  6. Click "Generate token".

Connecting Jira to GitHub

Once you've generated your token, you can connect Jira to GitHub:

20 GITHUB REPOSITORIES EVERY AI ENGINEER SHOULD KNOW
20 GITHUB REPOSITORIES EVERY AI ENGINEER SHOULD KNOW
15 GITHUB REPOSITORIES EVERY DEVELOPER SHOULD STAR
15 GITHUB REPOSITORIES EVERY DEVELOPER SHOULD STAR
  1. In Jira, click on the "Products" dropdown, then select "Jira Software".
  2. Select "Issues" from the left sidebar, then click on "Configure" in the "Apps" section.
  3. Search for the "GitHub Integration" app. If it's not installed, click "Install" to add it.
  4. Once installed, click on the app's tile to set it up. Enter your GitHub PAT in the "Token" field, then select your organization or repository.
  5. Click "Test connection" to ensure Jira can communicate with GitHub, then click "Configure".

Configuring Git Issues to Sync with Jira

Now that Jira is connected to GitHub, you can configure GitHub Issues to sync with Jira, allowing you to manage both from a single platform.

To configure the sync:

AD

Syncing GitHub Issues to Jira

  1. In Jira, go back to the "Configure" page for the GitHub Integration app.
  2. Under "GitHub Issues", select the repository you want to sync with Jira.
  3. Choose whether you want to create Jira issues from GitHub issues and pull requests, and vice versa.
  4. Click "Configure".

Mapping GitHub Issues to Jira Projects

To ensure issues are mapped correctly to your Jira projects:

  1. In the GitHub Integration app's configuration, click on "Project mapping".
  2. Select the GitHub repository and Jira project you want to map together.
  3. Choose the issue types you want to map (e.g., 'Bug' to 'Jira Issue', etc.).
  4. Click "Create mapping".

Once configured, any changes made to issues in either GitHub or Jira will auto-sync between the two platforms.

Using the GitHub Integration App

The GitHub Integration app provides additional features like:

AD
  • Syncing pull requests and pull request reviews.
  • Syncing code reviews and merge requests.
  • Viewing and managing GitHub issues and pull requests directly in Jira.

The app's documentation provides detailed instructions on how to use these features. Remember to explore and configure these options to suit your team's workflow.

By integrating Jira with GitHub, you can create a seamless development pipeline. Your team can collaborate more effectively, and you can track progress in a single tool. However, ensure you regularly review and update your configurations to align with your evolving workflows. Happy integrating!

AD