How To Set up a GitHub to Jira Integration (2 Methods)
Maybe your developers are sick of copying and pasting their updates from GitHub to Jira. Or maybe product managers, team leads, and other stakeholders have no idea what’s going on in GitHub and are struggling to properly steer your projects. No matter what initially sparked the need, you have to find a GitHub integration for Jira that’ll work without breaking the bank. So what do you do?
Read on to learn about the two most popular methods for setting this up. Or you can follow our detailed guide on how to quickly sync issues between GitHub and Jira with Unito.
First method: Use the built-in GitHub to Jira integration
Did you know that Atlassian offers a free app for setting up a GitHub integration with Jira? With a few clicks and some configuration, you can quickly start integrating updates from GitHub into your Jira issues, giving PMs and team leads a way to check in on development work without having to dive into a GitHub repository.
Here’s how you can set this up.
Install the app
Start by going to the Atlassian marketplace, where you can find a ton of apps that can help you tailor your Jira projects to your needs. You’ll find the GitHub for Jira app here, or by searching up “GitHub for Jira” on the marketplace.
From there, just hit Get it now to start adding it to your Jira workspace. If you’re not logged in to Jira, you may need to log in, and then pick the Jira project you want to add the app to. Otherwise, you’ll be taken to your Jira workspace where you’ll see this screen. Hit Get it now.
It should only take a few moments for the app to be added to your Jira workspace, and then you’re ready to start.
Setting up your GitHub integration with Jira
Now that the GitHub for Jira app is added to your workspace, it’s time to connect it to your GitHub repository. You should see this screen.
Hit Get Started.
After that, hit Connect GitHub organization.
Here, choose whether you’re connecting a repository from GitHub Cloud or GitHub Server. If you’re not sure what you need to connect, get in touch with IT or a system administrator. After you’ve picked the right option, hit Continue. You’ll then get this screen.
This lists the permissions that Jira needs in order to properly sync issues across tools. If you’re not sure what you’re looking at, get in touch with IT or an administrator before you hit Authorize Jira. Once that’s done, you’ll see this.
That’s because there’s still a bit of setup to do on the GitHub side. Start by hitting Install GitHub for Jira on a new organization.
At this stage, you’ll be adding a Jira connection to the GitHub repositories you want to sync. You can choose to connect all repositories associated with your GitHub, or only a select few. Once you’ve chosen the repositories you want to connect, just hit Install, following which you’ll see this.
Now hit Connect on the Jira site you want to sync with GitHub.
And just like that, you’ve just set up your GitHub integration with Jira. The GitHub for Jira app will start picking up your GitHub data and sending it over to your Jira projects — that’s what the blue In Progress tag means. Once that’s done, you’ll see that data in your Jira issues!
Anyone working in your Jira projects can use a GitHub issue number to link it with a Jira issue, and see branches, commits, and pull requests without leaving Jira.
Limitations of this method
So while you can easily set up a GitHub integration with Jira using this free app, is it the best for the job? Here’s why that might not be the case.
- It’s a snapshot: While this integration is easy to set up, it doesn’t give you a full picture of what’s happening in GitHub. That’s fine for some workflows, but some teams need more.
- It’s not a true two-way sync: A two-way sync doesn’t just push data, it also keeps everything up to date in both tools. While you’ll get up-to-date data about what’s going on in GitHub in your Jira projects, your developers won’t have the same level of information.
- It only works for Jira and GitHub: If your organization only uses Jira and GitHub, then this won’t be an issue. But if you have other teams using their own PM tools, spreadsheets, or any other kind of tool, then you’ll need a different integration for each tool.
With this in mind, let’s look at a better way to set up a GitHub integration with Jira that you can rely on.
Second method: Use Unito’s GitHub integration with Jira
Unito is a no-code workflow management solution with some of the deepest integrations for the most popular tools on the market, including GitHub, Jira, GitLab, Asana, Trello, Azure DevOps, Google Sheets, Excel, and more. With a single Unito flow, you can automatically push data from GitHub issues to Jira — and back — keeping everything in sync in both tools. That means developers can keep working in GitHub without hopping into Jira, trusting Unito to keep PMs and team leads in the know automatically.
Here’s why Unito is the best solution for setting up a GitHub integration with Jira.
- It syncs more fields: Whether you need your developers to know which Jira sprint their work is part of or your PMs to get access to GitHub labels, Unito is the best way to sync all your data.
- It’s a true two-way sync: Unito doesn’t just push data from one tool to the other. It keeps everything up to date in real-time, so that everyone’s working with the latest information.
- It works with over 30 tools: Spreadsheets, PM tools, CRM platforms, and databases are just a few examples of all the tools Unito supports.
Ready to start? Here’s how simple it is to set up a GitHub integration with Jira using Unito.
- First, connect your tools to Unito.
At this stage, you’ll also pick the GitHub repository and Jira project you want to sync.
- Next, set up flow direction.
This will determine where new issues are created. If you’re only looking to dispatch work from Jira to GitHub, for example, set up a one-way flow from Jira to GitHub.
- Now use rules to filter out the issues you don’t want synced.
You don’t have to push all issues between tools. Unito can automatically filter out issues based on their type, labels, milestone, sprint, and more.
- Finally, map fields between GitHub and Jira.
Unito can map most of these automatically, but it’s a good idea to review these mappings and tinker with them as needed.
And that’s it! Now just launch your flow and watch as your GitHub integration with Jira automatically pushes issues between tools, keeping everything in sync.