Blocking an Issue

This page shows how to block one issue with another issue in Google Issue Tracker.

When one issue blocks another, it means that the first issue should be resolved before the second one is resolved. Blocking is intended for tracking purposes only. Issue Tracker itself does not enforce blocking. An issue can be marked Fixed even if it has open issues blocking it.

The blocking feature is reciprocal. If you set one issue to block a second issue, the first appears in the Blocked By list of the second, while the second appears in the Blocking list of the first.

You must have Edit Issues permissions for the components that contain both issues in order to set the blocking relationship.

Blocking issues

When you block an issue, you indicate that the issue should not be resolved until another issue is resolved. The issue that needs to be resolved first is the blocking issue, while the issue that will be resolved second is the blocked issue. An issue can block and/or be blocked by multiple issues at the same time.

Blocking does not impose any actual restrictions on issues. That is, the blocked issue can still be updated or closed even if no changes are made to the blocking issue. For this reason, blocking should be thought of as a tracking or notification system. Decisions regarding how to respond to a blocked issue are left to the individuals and teams responsible for resolving the issue.

Blocking is tracked in the Related Issues tray of both the blocked and blocking issue. For example, if you go to Issue A's page and set it to block Issue B, then the page for Issue A lists Issue B in its Blocking drop-down tab, while the page for Issue B lists Issue A in its Blocked by drop-down tab.

The title of the Blocking and Blocked By tabs show how many issues are in the drop-down section of each. The number preceding the / is the number of open issues and the number following / is the total number of issues. For example, if the Blocking tab reads 2/5, then there are 5 issues in total set that block the current issue, but only 2 of those issues have yet to be resolved.

Clicking on either the Blocked By or Blocking tab displays a list of relevant issues. Each issue entry has several parts:

  • Status icon: Hover over the status icon to display the status as text.
  • Issue ID: Hover over the issue ID to display a Hovercard for that issue.
  • Issue Title: Click on the title to open the issue details page in a new tab.
  • X: Click on the X to remove the entry from the list of blocked/blocking issues.

You can also click on the View in Issue List link to view a search results page that contains the issues listed in the drop-down tab. This is helpful, for example, if you want to perform a bulk edit on the issues in the list.

Set an issue to be blocked by another

To set an issue as blocked by another issue:

  1. Navigate to the issue that is to be blocked.

  2. In the Related Issues Tray near the top of the page, click Blocked By.

  3. Click Add blocking issue.

  4. There are two options to enter the blocking issue. Option 1: text search for the issue.

    Option 2: enter the issue id(s). New: Multiple IDs, separated by commas, can be added at a time.

  5. Click Add Blocking Issue.

    If successful, Issue Tracker notifies you that the blocking issue has been added. For example:

    "62498424" added to Blocking Issues.

    The blocking issue then appears in the Blocked By list.

Set an issue to block another

To set an issue as blocking another issue:

  1. Navigate to the issue that will be blocking.

  2. In the Related Issues Tray near the top of the page, click Blocking.

  3. Click Add Blocked Issue.

  4. There are two options to enter the blocked issue. Option 1: text search for the issue.

    Option 2: enter the issue id(s). New: Multiple IDs, separated by commas, can be added at a time.

  5. Click Add blocked Issue.

    If successful, Issue Tracker notifies you that the blocked issue has been added. For example:

    "20189309" added to Blocked Issues.

    The blocked issue then appears in the Blocking list.

What's next