Jira
Connect your Jira workspace to keep issues and pull requests in sync
Beta Feature
Jira Integration is currently in beta. We're actively improving this feature based on user feedback.
Overview
The Gitar Jira Integration enables your team to seamlessly connect Jira issues with your pull requests. When integrated, Gitar can read Jira issues, update ticket status, and add comments, keeping your project management and code reviews in sync.
Features
- Auto-Link Issues - Gitar can automatically detect and link relevant Jira issues to pull requests, even when ticket references are missing.
- Post Merge Summaries - Gitar can add implementation summaries to linked Jira issues when pull requests are merged.
- Link Related Issues - Gitar can establish relationships between multiple Jira issues when they're worked on together in the same pull request.
- Suggest Reviewers - Gitar can suggest reviewers based on Jira issue watchers and stakeholders.
- Create Follow-up Issues - Gitar can create follow-up Jira issues for unresolved review comments and new TODOs introduced in merged code.
Authentication Methods
Gitar supports two ways to authenticate with Jira:
OAuth 2.0 (Recommended)
OAuth provides secure, one-click authentication with automatic token refresh. No manual token management required.
Personal Access Token (PAT)
Personal Access Tokens provide direct API access with manual token management.
Get Started with OAuth
Follow these steps to connect your Jira workspace using OAuth 2.0 (recommended).
OAuth App Setup Required
Before connecting with OAuth, ensure your organization has configured the Gitar OAuth app in the Atlassian Developer Console. Contact your administrator if you need access or assistance with OAuth app configuration.
Navigate to your organization's settings in the Gitar dashboard to begin the integration:
- Navigate to your organization's Settings in the Gitar dashboard
- Go to the Integrations section
- Find the Jira card under Ticketing & Documentation and click Connect
In the Jira connection dialog, you'll see two authentication options:
- Select the OAuth tab
- Click Connect with OAuth
You'll be redirected to Atlassian's authorization page:
- Select your Atlassian site
- Review the permissions requested
- Click Accept to authorize Gitar
Once authorized, you'll see a confirmation that your Jira integration is connected.
Get Started with Personal Access Token
Follow these steps to connect using a Personal Access Token.
Create a Personal Access Token in your Atlassian account:
- Go to Atlassian API tokens page
- Click Create API token
- Give it a descriptive name (e.g., "Gitar Integration")
- Copy the generated token (you won't be able to see it again)
Return to the Gitar Jira integration dialog:
- Select the Personal Access Token tab
- Enter your Jira Instance URL (e.g.,
https://your-company.atlassian.net) - Enter your Jira User Email
- Paste your Personal Access Token
After entering all the required information:
- Review your credentials
- Click Save to complete the connection
Your Jira PAT integration is now active and ready to use.
Frequently Asked Questions
What permissions does Gitar need?
For OAuth, Gitar requests:
- Read Jira issues and user information
- Write to Jira (create/update issues, add comments)
- Offline access (for automatic token refresh)
How often are OAuth tokens refreshed?
OAuth tokens are automatically refreshed before they expire to maintain continuous connectivity. No manual intervention required.
What happens if my PAT expires?
You'll need to generate a new token and update it in Gitar by going to Settings → Integrations → Jira → Configure.
Enable Jira Features
Once your Jira integration is connected, you can enable specific features through your repository's Rules page:
- Navigate to your repository in the Gitar dashboard
- Go to Rules in the sidebar
- Find the Jira-related rules and toggle them on
