Common Setup Issues
Solutions to the most common problems when connecting or using GitConnect for Jira.
Repository Shows "Error" Status
| Cause | Fix |
|---|---|
| Token or OAuth grant expired or revoked | Generate new credentials and update them via the integration's row Actions → Settings |
| Token missing required scopes | Re-generate the token with the scopes listed in Creating Personal Access Tokens |
| Repository renamed, transferred, or deleted | Disconnect the old entry and add the repository again under its new location |
OAuth Option Isn't Available
OAuth sign-in is only offered for GitHub.com and GitLab.com, and its availability can also depend on your organization's compliance configuration. If you don't see an OAuth option in the Add Integration wizard, use a personal access token instead - see Creating Personal Access Tokens.
Commits Aren't Appearing on an Issue
- Confirm the issue key in the commit message, branch name, or pull/merge request title exactly matches the Jira project key and issue number (e.g.
PROJ-123, notproj-123orPROJ 123) - Confirm the repository has finished its initial sync - check Last Synced in Manage Integrations
- Confirm the repository is still connected and its status is not Error
Can't Create a Branch or Pull/Merge Request from Jira
This action requires Write access on GitHub or Developer access on GitLab for the connected repository's credentials. Read-only connections can display activity but cannot create branches or pull/merge requests. Update the token's scopes, re-authorize with an account that has write access, or ask someone with the Manage Integrations permission to reconnect the repository.
Smart Commit Commands Not Working
- Confirm the commit message format matches Smart Commits exactly, including the
#before each command - Confirm the issue key is valid and belongs to a project the app can access
- Confirm any workflow transition command (e.g.
#resolve) matches an available transition name on the issue's current status
If an issue persists after checking the above, see Help & Support.