Skip to main content

Using tickets in Pipelines

Where linked tickets show in Pipelines, and how to link a ticket to an existing pull request or find a ticket.

Written by Josh Camilleri

License requirements:
Ticket tracking in Pipelines is available on Deployment Teams and Deployment Enterprise licenses.

Pipelines shows linked tickets on features, pull requests, and releases. You can link a ticket when you create a feature, or add one to a pull request later.

To link a ticket when you create a feature, see Configuring ticket tracking in Pipelines.

Where do linked tickets show in my pipeline?

  • The feature sidebar shows the tickets attached to a feature. A feature with one ticket shows its reference, and a feature with several shows a count.

  • Bundles will also show the tickets from all of the features combined in the same place.

    Pipeline environment panel with Open pull requests selected and the Tickets section highlighted, showing a linked ticket.

  • The same tickets show as pills when you click Commit more changes on an existing feature.

Feature panel with an arrow pointing to the ticket pill next to Commit more changes, and the Tickets section highlighted.

If you can't access a ticket, Gearset shows its reference only. To see its details, add a personal connection to that ticket system.

Releases

When adding Pull Requests into Releases the tickets will combine and show in the Tickets tab in the Pull Request. As shown below:
​

Environment panel with the Releases tab open and Tickets selected, showing two linked tickets in a release.

How do I link a ticket to an existing pull request?

  1. Open the pull request details.

  2. In the ticket section, click the add ticket button.

    Pull request Tickets section with the Provider list open, showing Azure DevOps, Jira, Linear, and Salesforce.

  3. Select the provider that has the ticket you want to add.

  4. Click Add.

The linked ticket now shows in the pull request details.

What if my tickets don’t show correctly on a pull request?

  1. Check that the pipeline’s ticket system connection exists. See Ticket system connections and permissions in Pipelines.

  2. In the pull request’s ticket section, click the refresh button:

    Pipeline with Open pull requests selected and an arrow pointing to the refresh button in the Tickets section.

How does Gearset link tickets to my pull requests?

Gearset reads ticket references from the pull request title and description. It doesn’t read references from the branch name.

Can I make my team link a ticket?

Yes. Turn on Require issue tracking in the Deployment settings on your My account page. Each pull request and Compare and Deploy deployment then needs a linked ticket.
​

Deployment settings page with an arrow pointing to the Require issue tracking toggle under Deployment tracking.

Note: This setting currently works for Jira issues and Azure DevOps work items and Asana Tasks (Compare and Deploy) only.

Summary of items to deploy page with Jira, Azure DevOps, and Asana panels and a message to use issue tracking.

Useful resources

Did this answer your question?