Jira PR Inbox
A Jira Cloud app that connects your Jira instance to GitHub, showing PRs that need reviewing at a glance.
Features
Jira PR Inbox bridges the gap between your issue tracker and code reviews. It surfaces pull requests that need attention directly in Jira, so your team never misses a review and PRs don't go stale.
Getting Started
Setup, Configuration & Usage
Installation
- 1
Install from the Atlassian Marketplace
Search for "PR Inbox for Jira" on the Atlassian Marketplace, click Get it now, and select your Jira Cloud site.
- 2
Find PR Inbox in Jira
After installation, PR Inbox appears in your Jira left-hand navigation sidebar. Click it to open the app.
Connect Your GitHub Account
Each team member connects their own GitHub account. PR Inbox uses OAuth and only reads data — it never modifies your repositories.
- 1
Open PR Inbox and click Connect GitHub
On first use you will see a connection prompt. Click the button to start the OAuth flow.
- 2
Authorize on GitHub
A GitHub consent screen will ask for repo (read access to repositories and pull requests) and read:org (organization membership) permissions. Click Authorize.
- 3
Start reviewing
Once authorized, PR Inbox loads all open pull requests where your review has been requested.
Using the Inbox
The inbox organizes pull requests into four sections: Ready to merge (approved, non-draft PRs), Waiting for review (PRs that need your review), Changes requested (PRs with requested changes), and In progress (draft PRs). Use the sidebar to filter by repository, status, or quick filters like New PRs, Old PRs (7+ days), and XL PRs (1,000+ lines). A search bar lets you filter by repo name, PR title, or author.
Configure Settings
- 1
Bot authors
Add GitHub usernames like dependabot or renovate to treat as bots. Their PRs are hidden from the main inbox and shown in a separate section.
- 2
Featured repos
Pin your most important repositories to the top of the sidebar for quick filtering. Use the format owner/repo.
- 3
Disconnect
Unlink your GitHub account from the Settings tab at any time. You can reconnect whenever you need to.
Testing the App
To verify the integration is working: create or find a pull request on a repository you have access to, then request your own review (or have a teammate request yours). Refresh PR Inbox — the PR should appear under Waiting for review. Approve the PR on GitHub and refresh again to see it move to Ready to merge.