- jira
- github
- integrations
- how-to
How to link Jira to GitHub pull requests (and fix links that don't show up)
Set up the GitHub for Atlassian app, link branches, commits and pull requests to Jira work items, use Smart Commits, and fix the most common reasons a pull request doesn't appear in Jira's development panel.
The KnowWhyy team6 min read
Linking Jira to GitHub does one valuable thing: from any Jira work item you can see the branches, commits and pull requests that implemented it, and from any pull request you can get back to the ticket that explains why it exists. When it works, it's the cheapest way to keep code and reasons connected. When it doesn't, the pull request just never shows up, and nobody's sure why.
This guide covers setup, how linking actually works, Smart Commits, and a troubleshooting checklist for links that don't appear. It reflects Jira Cloud and the GitHub app as of November 2026. Two renames to know first: the "GitHub for Jira" app is now listed as GitHub for Atlassian, and Jira now calls issues work items.
Step 1: install the GitHub for Atlassian app
The app is free, built by Atlassian, and works with Jira Cloud. You need two people (or one person with both roles): a Jira site admin and a GitHub organization owner.
- In Jira, go to Apps > Explore more apps, search for GitHub for Atlassian, and select Get app.
- Choose GitHub Cloud, pick your GitHub organization, and select Connect. Only organization owners see the Connect button.
- Optionally, let GitHub data feed Atlassian Rovo, if you use it.
Atlassian's setup guide has screenshots. GitHub Enterprise Server needs a separate setup with a manually created GitHub App ().