Jira Integration

Learn how to integrate BrowserStack Percy with JIRA Cloud to track visual review statuses, streamline workflows, and increase visibility for your team.

BrowserStack Percy’s Jira integration lets you connect your Percy Project with Jira Cloud for easier reporting of visual review findings. You can create Jira tickets 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 Jira with Percy while creating a ticket 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 ticket creation.

  Click Report a bug, then authenticate using Continue with OAuth to log in using OAuth or Continue with PAT to use a Personal Access Token (PAT). After successful authentication, Percy opens the Jira ticket form with mandatory fields such as Host, Project, Issue type, and Summary.

• Option 2: Enable group-level access

A Group Admin can enable group-level access for their team from the Accounts & Profile page by toggling the Enable Group Level Access for my team option. When you use this option, Percy creates all Jira tickets with the Group Admin as the reporter.

Step 3: Enter the required Jira issue details in the ticket dialog.

• When you create a Jira issue for the first time, enter details such as the Jira host, project name, issue type, assignee, and summary.
• For subsequent issue creation, Percy automatically fills the Jira host and project name.

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

Step 4: Click Create or Update.

Percy creates or updates the Jira issue and links it to the selected snapshot.

How to check?

Percy creates Jira tickets at the snapshot level. You can access created tickets from multiple places in the Percy review experience:

• Build-level ticket count on the Percy build review screen
• Snapshot thumbnail, which shows linked Jira issues
• Issue count on the Report a bug icon

These indicators help you quickly identify which snapshots already have associated Jira issues.

How to open the ticket?

After Percy creates a Jira ticket:

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

Percy opens the Jira issue in a new tab, where you can track status, add comments, or update fields.

How to de-link?

You can remove the association between a Jira ticket and a Percy snapshot if the link is no longer needed.

1. Open the Percy build where the Jira ticket is linked.
2. Locate the linked Jira issue.
3. Click Delink next to the issue.

1. Confirm the action.

Percy removes the association between the Jira issue and the snapshot. This action does not update or close the Jira ticket.

Troubleshooting

• Jira Cloud only: The integration does not support Jira Server or Data Center.
• Tickets not visible: Verify that the Percy Project maps to the correct Jira project and that required permissions are in place.
• Authentication errors: Re-authenticate with Jira if the connection fails.

Need more support? Contact BrowserStack.