Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gitar.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Gitar Jira Integration seamlessly connects Jira issues with your pull requests. Gitar can read issues, update status, and add comments — keeping project management and code reviews in sync.

Auto-Link Issues

Detect and link Jira issues even when ticket references are missing

Post Merge Summaries

Add implementation summaries to linked issues when PRs merge

Suggest Reviewers

Suggest reviewers based on Jira watchers and stakeholders

Create Follow-ups

Create follow-up issues for unresolved comments and new TODOs

​
Authentication Methods

Gitar supports two ways to authenticate with Jira: 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).
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.
1

Access Gitar Integrations

Navigate to your organization’s settings in the Gitar dashboard to begin the integration:
  1. Navigate to your organization’s Settings in the Gitar dashboard
  2. Go to the Integrations section
  3. Find the Jira card under Ticketing & Documentation and click Connect
Jira integration card in Gitar settingsJira integration card in Gitar settings
2

Select OAuth Authentication

In the Jira connection dialog, you’ll see two authentication options:Jira authentication options - OAuth and PAT tabsJira authentication options - OAuth and PAT tabs
  1. Select the OAuth tab
  2. Click Connect with OAuth
OAuth authentication selection in Jira integration dialogOAuth authentication selection in Jira integration dialog
3

Authorize with Atlassian

You’ll be redirected to Atlassian’s authorization page:
  1. Select your Atlassian site
  2. Review the permissions requested
  3. Click Accept to authorize Gitar Atlassian OAuth authorization page
4

Connection Successful

Once authorized, you’ll see a confirmation that your Jira integration is connected.Jira OAuth integration successfully connectedJira OAuth integration successfully connected

​
Get Started with Personal Access Token

Follow these steps to connect using a Personal Access Token.
1

Generate a Jira API Token

Create a Personal Access Token in your Atlassian account:
  1. Go to Atlassian API tokens page
  2. Click Create API token
  3. Give it a descriptive name (e.g., “Gitar Integration”)
  4. Copy the generated token (you won’t be able to see it again)
2

Enter PAT Credentials

Return to the Gitar Jira integration dialog:
  1. Select the Personal Access Token tab
  2. Enter your Jira Instance URL (e.g., https://your-company.atlassian.net)
  3. Enter your Jira User Email
  4. Paste your Personal Access Token
Enter Jira PAT credentials formEnter Jira PAT credentials form
3

Save Configuration

After entering all the required information:
  1. Review your credentials
  2. Click Save to complete the connection
PAT credentials ready to savePAT credentials ready to save
4

Connection Successful

Your Jira PAT integration is now active and ready to use.Jira PAT integration successfully connectedJira PAT integration successfully connected

​
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:
  1. Navigate to your repository in the Gitar dashboard
  2. Go to Rules in the sidebar
  3. Find the Jira-related rules and toggle them on
Jira rules configuration in Gitar dashboardJira rules configuration in Gitar dashboard