Dependencies on issues are now generally available! You can now specify which issues are blocked by or blocking others, making it easy for teams to define work that must be completed before other work can begin. This has been one of our most requested features.

➕ Getting started

To get started, open the Relationships section in the issues sidebar and select Mark as blocked by or Mark as blocking. You can link up to 50 issues for each relationship type.

🔍 Search and view blocked issues

You can view blocked issues in your projects and in the repository Issues tab. You can also get started by using the following filters to search for them:

  • is:blocked — returns all blocked issues
  • is:blocking — returns all issues that are blocking others
  • blocked-by: — returns issues blocked by a specific issue
  • blocking: — returns issues blocking a specific issue

⚙️ API and webhooks

Issue dependencies are fully supported in the API and webhooks. Learn more in our documentation:

✍️ Tell us what you think!

Join the conversation within GitHub Community, or select Give feedback from the projects ... menu to share your feedback!

See how to use GitHub for project planning with GitHub Issues and Projects, check out what’s on the roadmap, and learn more in our GitHub Issues documentation.