How to Link Azure DevOps Tickets to GitHub Pull Requests

How do you link Azure DevOps tickets to GitHub pull requests? You link Azure DevOps tickets to GitHub pull requests by enabling integration between the two platforms and using specific commit or PR message syntax that references Azure Boards work items, allowing development activity in GitHub to be tracked directly in your Azure DevOps project management workflows.

For enterprise executives, linking Azure DevOps tickets to GitHub PRs enhances traceability, improves team collaboration, and strengthens compliance by creating a unified view of code changes and business requirements across tools.

Step 1: Prerequisites and Account Access

Before linking the two systems, ensure the following:

• You have an Azure DevOps organization and project with Boards enabled
• You have a GitHub repository where PRs will be created
• You have the necessary admin or integration permissions on both platforms

Tip: Use a service account or shared integration user for consistent access and visibility across projects.

Step 2: Install the Azure Boards GitHub App

Azure DevOps uses a GitHub App to enable integration between GitHub and Azure Boards.

To install the app:

1. Go to your Azure DevOps project
2. Navigate to Project Settings > GitHub connections
3. Click Connect GitHub account
4. You’ll be redirected to GitHub to install the Azure Boards app on your organization or repository
5. Grant access to the appropriate repositories

Alternatively, install it directly from the GitHub Marketplace: Azure Boards GitHub App

Integration Insight: This connection enables Azure Boards to monitor GitHub activity and link it to work items automatically.

Step 3: Link GitHub Repository to Azure Boards

Once the app is installed:

1. In Azure DevOps, go to Boards > Repos
2. Click Link GitHub repo
3. Select your GitHub organization and repository
4. Confirm the connection and permissions

Azure Boards will now be able to track commits and pull requests from this repository.

Step 4: Use Syntax to Link Work Items in GitHub

You can link Azure DevOps work items (tickets) to pull requests or commits using special syntax.

In Pull Request Titles or Descriptions:

AB#123

Fixes AB#456

Implements AB#789

In Git Commit Messages:

git commit -m “Fix AB#456 – resolve login redirect issue”

This will:

• Add a link from the work item to the PR or commit
• Automatically update the work item status (e.g., move to “In Progress”)

Best Practice: Adopt a consistent commit message convention across teams to ensure reliable tracking and reporting.

Step 5: Verify Linked Work Items in Azure DevOps

To confirm the integration is working:

1. Go to Boards > Work Items
2. Open a linked item (e.g., AB#123)
3. Scroll down to the Development section
4. You should see references to the GitHub PR, commits, and branches

You can also filter and report on work items based on development activity.

Executive Tip: Use Azure DevOps Dashboards to visualize progress across epics, features, and linked GitHub activities.

Step 6: Enable Automation and Compliance Workflows

Take full advantage of the integration by:

• Enforcing PR templates that require work item references
• Using branch policies in GitHub that require linked tickets before merging
• Automating status changes in Azure Boards based on GitHub events

For example:

• Automatically move work items to “Done” when a PR is merged
• Trigger Azure Pipelines builds based on PR activity linked to work items

Automation Insight: These automations improve visibility, reduce manual updates, and support agile reporting at scale.

Final Thoughts

Linking Azure DevOps tickets to GitHub pull requests bridges the gap between planning and engineering. It enables traceable, auditable workflows that connect code changes with business objectives, boosting productivity, accountability, and alignment across teams.