Skip to content
Work Management Hub Work Management Hub

Expert Reviews, Comparisons & Guides for Smartsheet, Monday.com, Asana, ClickUp & More

Work Management Hub Work Management Hub

Expert Reviews, Comparisons & Guides for Smartsheet, Monday.com, Asana, ClickUp & More

  • Smartsheet
  • ClickUp
  • Asana
  • monday.com
  • Other tools
    • Jira
    • Notion
    • Wrike
    • Airtable
  • Comparisons
  • Guides
  • About
  • Smartsheet
  • ClickUp
  • Asana
  • monday.com
  • Other tools
    • Jira
    • Notion
    • Wrike
    • Airtable
  • Comparisons
  • Guides
  • About
Close

Search

Close-up of a laptop showing code in an editor
How-To GuidesIntegrationsJira

How to Connect Jira and GitHub: Setup, Smart Commits, and Fixes

By Khasim Basha Shaik
May 9, 2026 5 Min Read
0

Home - How-To Guides - How to Connect Jira and GitHub: Setup, Smart Commits, and Fixes

To connect Jira and GitHub, install the free GitHub for Atlassian app from the Atlassian Marketplace, then connect your GitHub organization. You need Jira site admin permission to install the app and GitHub organization owner permission to connect the org; often that’s two different people. After that, anything your team names with a Jira key (like PAY-142) in a branch name, commit message, or pull request title shows up in the work item’s development panel.

The steps below follow Atlassian’s Connect GitHub Cloud to Jira guide and Smart Commits reference, plus the GitHub for Atlassian Marketplace listing (listed as a free app), checked October 10, 2026.

Table of Contents

Toggle
  • Before you start
  • Step 1: Install GitHub for Atlassian
  • Step 2: Connect your GitHub organization
  • Step 3: Link your work with Jira keys
  • Step 4: Use Smart Commits (carefully)
  • Step 5: Add builds and deployments
  • Connect new repositories later
  • Troubleshooting
  • Common questions
    • Is the GitHub for Jira app free?
    • Who needs to set up the Jira GitHub integration?
    • Can I connect multiple GitHub organizations to one Jira site?
    • Does it work with GitHub Enterprise?
    • Why aren’t my commits showing up in Jira?

Before you start

You needWhy
Jira site adminTo install the app
GitHub organization ownerTo connect the org and approve repo access
A decision on All repositories vs Only select repositories“All” picks up new repos automatically; “select” means adding each new repo by hand
An agreed key conventionNothing links unless people use the Jira key

The app works with GitHub Cloud and GitHub Enterprise Cloud. GitHub Enterprise Server uses a separate setup path in Atlassian’s docs.

Step 1: Install GitHub for Atlassian

  1. In Jira, select Apps → Explore more apps.
  2. Search for GitHub for Atlassian.
  3. Select Get app → Get it now.

Step 2: Connect your GitHub organization

  1. After install, select Get started (or later: Apps → Manage your apps → GitHub for Atlassian).
  2. Select Continue → GitHub Cloud → Next, and sign in to GitHub.
  3. Find your organization and select Connect. You only see Connect if you’re an org owner.
  4. Not an owner? Choose Send them a link and ask them to connect and send it to an owner.
  5. If your org isn’t listed, install the Jira app on that GitHub org first, choosing All repositories or Only select repositories.
  6. Choose whether GitHub data should be available in Atlassian Rovo (search, chat, and agents). You can leave it off and the integration still works.
  7. Confirm the org appears under Apps → Manage your apps → GitHub for Atlassian.

You can connect more than one GitHub organization to the same Jira site from the same screen.

Close-up of a laptop showing code in an editor
The integration only links work that carries a Jira key. Photo: Marc Mueller, CC0.

Step 3: Link your work with Jira keys

Table showing where to put the Jira key in branch names, commits, PR titles and Smart Commit commands, and what appears in Jira
Put the key everywhere and Jira does the rest. Chart: WorkManagementHub, from Atlassian Support.
WhereExampleWhat shows in Jira
Branch namegit checkout -b PAY-142-retry-webhooksBranch in the development panel
Commit messagePAY-142 add retry on 503Commit linked to the work item
Pull request titlePAY-142 Retry failed webhooksPR and its status

You can also create a branch straight from a Jira work item, which pre-fills the key in the branch name. That one habit fixes most “why isn’t my PR showing up” complaints.

Step 4: Use Smart Commits (carefully)

Smart Commits let a commit message act on the work item:

CommandExampleEffect
#commentPAY-142 #comment fixed the retry backoffAdds a comment
#timePAY-142 #time 1h 30m tuned retriesLogs work (time tracking must be on)
TransitionPAY-142 #done #comment shippedMoves the work item through that workflow transition

The gotchas, all from Atlassian’s reference:

  • The committer’s email must match exactly one Jira user with permission to do the action. Commits from a personal email won’t run commands.
  • A transition silently fails if that transition has required fields or a screen. Keep Smart Commit transitions to simple ones.
  • If two transitions start with the same word (Start Review, Start Progress), use the hyphenated full name, like #start-review.

Many teams skip Smart Commit transitions entirely and let Jira automation move work items when a PR is opened or merged. It’s easier to debug.

Step 5: Add builds and deployments

The app can also send GitHub Actions workflow runs and deployments to Jira, so each work item shows whether its code reached staging or production. Atlassian documents this under “Link GitHub workflows and deployments to Jira.” It relies on the same Jira keys in branch names and commits, plus your deployment environments being set up in GitHub.

Connect new repositories later

If you chose Only select repositories, new repos aren’t added automatically. Go to Apps → Manage apps → GitHub for Jira → Configure, open the org’s … menu → Configure, then add the repo under Repository access in GitHub.

Copilot Projects is separate: The Copilot Projects workspace GitHub launched in October 2026 runs agent work in the GitHub Copilot app. Keep your Jira links on issues and pull requests as above.

Troubleshooting

SymptomLikely causeFix
No Connect buttonYou aren’t a GitHub org ownerSend the connect link to an owner
Org not in the listJira app not installed on that orgInstall it on the org, then connect
New repo’s PRs don’t appear“Only select repositories” was chosenAdd the repo under Repository access
Commits not linkedKey missing or lowercase in the messageUse the exact key, e.g. PAY-142
Smart Commit did nothingEmail mismatch, missing permission, or required fields on the transitionMatch commit email to Jira; simplify the transition
Data stopped syncingIP allowlist on the GitHub orgFollow Atlassian’s IP allowlist workaround article

If you’re deciding whether you need Jira at all next to GitHub, we compared our Jira guide and Linear vs GitHub Issues. For sprint workflows once the integration is running, see our Jira sprint planning guide.

Common questions

Is the GitHub for Jira app free?

Yes. GitHub for Atlassian is listed as a free app on the Atlassian Marketplace. You still pay for your Jira and GitHub plans.

Who needs to set up the Jira GitHub integration?

A Jira site admin installs the app, and a GitHub organization owner connects the organization and approves repository access.

Can I connect multiple GitHub organizations to one Jira site?

Yes. After connecting the first organization, you can add another from the same setup screen.

Does it work with GitHub Enterprise?

GitHub Enterprise Cloud uses the same steps. GitHub Enterprise Server has a separate setup path in Atlassian’s documentation.

Why aren’t my commits showing up in Jira?

Usually the Jira key is missing or mistyped in the branch, commit, or PR title, or the repository wasn’t included when the organization was connected.

Steps checked against Atlassian Support and the Atlassian Marketplace on October 10, 2026. Menu names in Jira change fairly often, so labels may differ slightly.

Related guides

  • Jira roadmap guide
  • Jira Forms setup
  • All Jira guides

From our team: OneSmar for Smartsheet Teams

OneSMAR for Smartsheet Teams - Available on the App Store

Tags:

2026Developer ToolsGitHubJiraJira Integration
Author

Khasim Basha Shaik

Khasim Basha Shaik is Co-Founder and Managing Director of SSPM Consultants, a Smartsheet Premier Partner based in Bengaluru, India. Since founding SSPM in 2018, he has spent 8+ years on Smartsheet implementation, integration, administration and support for client teams. On Work Management Hub he turns that hands-on work into plain setup guides, fixes and pricing breakdowns, and checks the numbers against official vendor sources.

Follow Me
Other Articles
Table of Smartsheet Microsoft Teams integration setup steps
Previous

Smartsheet + Microsoft Teams 2026: Setup, Alerts & Approvals

Table comparing free project management plans in 2026: users, key limits, automation and first paid plan for Jira, Trello, ClickUp, Linear, Airtable, Asana, monday.com, Notion and Wrike
Next

Best Free Project Management Tools in 2026, Ranked by Real Limits

No Comment! Be the first one.

    Leave a Reply Cancel reply

    Your email address will not be published. Required fields are marked *

    KB
    Khasim Basha Shaik

    Khasim Basha Shaik is Co-Founder and Managing Director of SSPM Consultants, a Smartsheet Premier Partner based in Bengaluru, India. Since founding SSPM in 2018, he has spent 8+ years on Smartsheet implementation, integration, administration and support for client teams. On Work Management Hub he turns that hands-on work into plain setup guides, fixes and pricing breakdowns, and checks the numbers against official vendor sources.

    About Work Management Hub →

    Popular reviews & guides

    • Table matching ten team types to the project management tool to start with, a runner-up and the reasonBest Project Management Software 2026: 10 Tools Compared by Team Type, Real Monthly Cost and the Limits That Matter
    • Team meeting around a long conference table with laptops openJira Pricing 2026: Standard vs Premium, Annual Tiers and the Oct 13 Increase
    • Developer working on a laptop with code on screen while holding a phoneJira Slack Integration 2026: Setup, @Jira Tickets and Channels Without the Noise
    • Laptop covered in developer stickers on a deskLinear vs GitHub Issues (2026): Who Should Track the Work?
    • Person typing on a laptop at a small round tableLinear-GitHub Sync Broken? Fix Every Failure Mode

    Browse by tool

    • Smartsheet29
    • Monday.com15
    • Asana17
    • ClickUp7
    • Notion18
    • Jira20
    • Wrike6
    • Airtable5
    • Integrations10

    From our team From our team: OneSmar for Smartsheet Teams, our own app

    Independent reviews, comparisons, and hands-on guides for work management tools: Smartsheet, Monday.com, Asana, ClickUp, Notion, Jira, Wrike, and Airtable. Written from daily, real-world use of these platforms.

    Topics

    • Smartsheet
    • Monday.com
    • ClickUp
    • Asana
    • Notion
    • Jira
    • Wrike
    • Airtable
    • Comparisons

    Company

    • About
    • Contact
    • Editorial Policy
    • Author

    Legal

    • Privacy Policy
    • Terms of Use
    • Disclaimer
    • Affiliate Disclosure
    Copyright 2026 Work Management Hub. All rights reserved. Blogsy WordPress Theme