Share via


Autocomplete work items with pull requests

TFS 2018

When you link a work item to a pull request (PR), you can automatically complete those work items when you complete the PR.

To learn more about pull requests, see Create, view, and manage pull requests.

Autocomplete work items

As shown in the following image, check the box to Complete linked work items after merging. The system defaults to your selection for future PRs.

Complete pull request dialog, Autocomplete work items with completion of PR option

In the following circumstances, the system won't automatically update the work item state to Done, Closed, or the state that belongs to the Completed category for the work item type:

  • The work item, whose work item type is managed with the Inheritance process model, is already in a State that belongs to the Resolved category. In this instance, the system won't update the State. For example, if a bug derived from the Agile process is in a Resolved state, the system won't transition it to Closed.
  • The work item is already in a State that belongs to the Completed category. No further transition is required.
  • The WIT associated with the work item contains one or more workflow field rules that prevent the work item being saved to a next state. For example, a rule requires that another field must be defined as part of closing the work item.
  • For on-premises deployments and Azure Boards Hosted process model, you must modify the workflow to specify actions (ACTION element) to take place when transitioning the workflow. See Change the workflow for a work item type, Specify Actions.

To learn more about process models, see Customize your work tracking experience.