ℹ️ Preview feature: Jira OAuth 2.0 connections are currently in closed beta. Contact us from within the Gearset app to learn more.
ℹ️ Are you reading the right guide?
For Jira on atlassian.net
See Integrating with Jira (this page)
Or for legacy connections see Integrating with Jira (Hosted/Cloud using legacy OAuth 1.0a)
For self-hosted Jira
Or for legacy connections see Connecting to an on-premise version of Jira (legacy OAuth 1.0a connections)
Gearset integrates with Jira Cloud so that deployment updates are automatically posted to your Jira tickets. This guide covers connecting your Jira Cloud instance to Gearset using OAuth 2.0.
Connecting to Jira Cloud
Admin configuration is typically not needed on the Jira side — any Gearset user can connect in a few clicks.
In Gearset, go to My connections > Source control and services (in the menu on the left).
Click Connect to Jira (OAuth 2.0). In the modal that appears, select Jira Cloud and click Connect.
You'll be redirected to Atlassian. Review the permissions Gearset is requesting, choose the Jira site you want to connect, and click Accept.
You'll be redirected back to Gearset. Your email address will appear next to the Jira OAuth 2.0 connection, confirming it's set up.
Team members
Any team member can connect their own Jira account by following the same steps above. Each person's updates to Jira tickets will be attributed to their own account.
Adding Jira tickets to deployments
When you're running a deployment, you can link Jira tickets so that Gearset automatically records what happened against them.
On the deployment summary page, click the Jira updates panel.
Search for tickets by title, description, or ticket reference (e.g.
PROJ-123).Select the tickets you want to link to the deployment.
When the deployment completes successfully, Gearset posts a comment on each linked ticket with details of what was deployed. You can configure the content of these messages in your deployment preferences.