Azure DevOps

Connect App Percy to Azure DevOps to file work items from a snapshot, with the snapshot image and build context attached.

BrowserStack Percy’s Azure DevOps integration lets you connect your Percy Project with Azure DevOps for easier reporting of visual review findings. You can create Azure DevOps work items from the Percy review dashboard at the snapshot level, including a specific browser and width combination. This helps you report issues faster without switching between tools.

How to integrate?

You integrate Azure DevOps with Percy while creating a work item from the Percy build review screen.

Step 1: Open the Percy build you want to review and click the Report a bug icon on the review screen.

Step 2: Choose one of the following authentication options (this is a one-time setup):

• Option 1: Authenticate during work item creation.

  Click Report a bug, then authenticate via the BrowserStack Integrations consent screen to grant access to the Azure DevOps organization and project you want to file against. After successful authentication, Percy opens the Azure DevOps work item form with mandatory fields such as Organization, Project, Work item type, and Title.

• Option 2: Enable group-level access

A Group Admin can enable group-level access for their team from the Accounts & Profile page. Locate Azure under Project Management Tools and click Connect.

Then toggle the Enable Group Level Access for my team option. When you use this option, Percy creates all Azure DevOps work items using the Group Admin’s authenticated session.

Step 3: Enter the required Azure DevOps work item details in the form.

• When you create a work item for the first time, enter details such as the organization, project, work item type, and title.
• For subsequent work item creation, Percy automatically fills the organization and project you used previously.

• When you update an existing work item, select a work item from the available list and update it as needed. Percy adds the latest snapshot details and screenshots to the work item description.

Step 4: Click Create or Update.

Percy creates or updates the Azure DevOps work item and links it to the selected snapshot.

How to check?

Percy creates Azure DevOps work items at the snapshot level. You can access created work items from multiple places in the Percy review experience:

• Build-level work item count on the Percy build listing screen
• Snapshot thumbnail, which shows linked Azure DevOps work items
• Work item count on the Report a bug icon

These indicators help you quickly identify which snapshots already have associated Azure DevOps work items.

How to open the work item?

After Percy creates an Azure DevOps work item:

1. Open the Percy build review screen.
2. Click the linked work item from the snapshot or the Report a bug panel.

Percy opens the work item in Azure DevOps in a new tab, where you can track status, add comments, or update fields.

How to de-link?

You can remove the association between an Azure DevOps work item and a Percy snapshot if the link is no longer needed.

1. Open the Percy build where the work item is linked.
2. Locate the linked work item.
3. Click Delink next to the work item.

1. Confirm the action.

Percy removes the association between the Azure DevOps work item and the snapshot. This action does not update or close the work item.

Troubleshooting

• Azure DevOps Services (Cloud) only: Azure DevOps Server (self-hosted) is not supported.
• Work items not visible: Verify that the Percy Project maps to the correct Azure DevOps organization and project, and that the OAuth scope grants access to them.
• Authentication errors: Re-authenticate with Azure DevOps if the connection fails. Confirm your browser is allowing third-party cookies for browserstack.com.
• Organization missing from the picker: Re-authenticate from Accounts & Profile > Integrations > Azure DevOps > Reconnect to grant the required scope.

Need more support? Contact BrowserStack.