• Products
  • Documentation
  • Resources

Integrate Jira Software with GitHub Cloud

Use the free GitHub for Jira app to seamlessly integrate with GitHub Cloud. The app allows you to easily track branches, pull requests, commits, builds, and more in Jira to stay up-to-date on your team's development work. Simply reference issue keys in GitHub to view development data in Jira and use smart commits to automate common tasks like transitioning issues or adding comments.

The instructions on this page are specific to integrating Jira Software with GitHub Cloud and GitHub Enterprise Cloud. If you are using GitHub Enterprise Server, go to Integrate with GitHub Server.

Before you begin

  • To integrate Jira Software and GitHub Cloud or GitHub Enterprise Cloud, you'll need admin permissions on both platforms.

  • If your GitHub organization uses IP allowlists, you must add IP addresses through View GitHub IP allow list configuration and if you need help, raise an issue here.

Install GitHub for Jira

  1. Sign in to your Jira Cloud account.

  2. Go to the Atlassian Marketplace by selecting Apps > Explore more apps in the top navigation.

  3. Search for GitHub for Jira and select Get app.

  4. Select Get started. You can also come back to the app’s configuration page later by going to Apps > Manage apps > GitHub for Jira > Get started.

Configure GitHub for Jira

  1. Select Connect GitHub organization.

  2. Select GitHub Cloud and click Continue.

Connect a GitHub organization

  1. Log in to your GitHub account, review the permissions, and click Authorize Jira.

  2. Find the GitHub organization you want to integrate with Jira and click Connect. Alternatively, select Install GitHub for Jira on a new organization.

  3. Back on the GitHub for Jira page, select Connect GitHub organization again and click Connect next to the organization you want to connect with Jira.

  4. At this point, GitHub for Jira will be hard at work backfilling your repository data from the last year. To change the date range, click Restart backfill and select your preferred start date.

  5. To connect more organizations, select Connect GitHub organization > Connect GitHub Cloud.

If you're using IP allowlists in your GitHub org, you may experience issues using GitHub for Jira. GitHub blocks some requests to the API even if the correct IP addresses are listed in the IP allowlist. To work around this problem, you must add the IP addresses through to your IP allowlist (you must add each IP address individually, not as a CIDR range). If our servers' IP address range changes, you must add the new IP addresses to continue using GitHub for Jira. Learn more about GitHub IP allowlist configuration.

If you experience any problems with IP allowlists, please raise an issue so we can help you.

Connect new GitHub repositories

If you originally gave the GitHub for Jira app access to "All repositories", and you've created a new repository on GitHub after configuration, your new repository will automatically work with the integration. However, if you installed the app on a subset of repositories, you will need to manually edit your repository selection by:

  1. Sign in to your Jira Cloud account

  2. From the top navigation bar in Jira, select Apps > Manage your apps > GitHub for Jira > Get started.

  3. Select Configure next to the relevant GitHub organization and add the new repository you want the app to integrate with.

After connection and configuration

Learn more about how to:

  • Link development information in a Jira project here.

  • Automate your company-managed projects with GitHub development and deployment information here.


Additional resources

To learn more or get help setting up and using GitHub for Jira for GitHub Cloud:


Additional Help