Skip to main content

Understanding and Fixing Unlinked Branches

Unlinked branches are branches your team is actively working on that are not associated with any tracked project issue. When branches are unlinked, LinearB cannot connect the work to planning, progre…

Steven Silverstone
Updated by Steven Silverstone

Unlinked branches are branches your team is actively working on that are not associated with any tracked project issue. When branches are unlinked, LinearB cannot connect the work to planning, progress, or delivery metrics.


What are unlinked branches?

An unlinked branch is a Git branch that does not match any project issue tracked by LinearB. This typically happens when the branch, pull request, or commits do not reference an issue ID.


Why unlinked branches matter

When branches are not linked to issues:

  • Work may be missing from project and delivery insights
  • Progress is harder to track against planned work
  • Cycle time and flow metrics may be less accurate

How to fix unlinked branches

To help LinearB match branches to issues, ensure that the issue ID appears in at least one of the following:

  • The branch name
  • The pull request title
  • A commit message

Using consistent naming conventions allows LinearB to automatically associate code changes with the correct issue.

Learn more about supported naming conventions

How did we do?

Troubleshooting: Pull Requests Are Not Showing in LinearB

Contact