Percy for Jira

Real-time Percy build status in Jira.

Getting Started

To begin, add a webhook in your Percy project. Go to the Percy project you would like to add the webhook and click the ‘Integrations’ tab.

Step 1: In the Percy project integrations, scroll down to ‘Webhooks’ & add a webhook:

Step 2: In the ‘URL’ field, fill in the URL found in the app’s ‘Get Started’ page in your Jira instance. Each URL is unique to each instance.

Step 3: Enable all build events, including ‘build_created’, ‘build_approved’, ‘build_finished’, ‘build_changes_requested’ and ‘build_unreviewed’. Then, create the webhook.

Step 4: Include the relevant Jira issue keys in the branch name or commit message. Run builds & see build status show up.

Example Usage

Use this app to:

…get quick status of builds:

…get details of builds (build numbers come from Buildkite):

…get build status of Jira issues in a release:

Frequently Asked Question (FAQ)

1. Why can’t I see any builds in Jira?

   There are a few reasons for this:

   • The description from Percy exceeded 255 characters. While we do our best to truncate it before sending it to Jira API, there are other inputs such as emojis which will go beyond the limited character length.

2. Why does the development panel showing failed builds and not the latest build?

   Unfortunately this is controlled by Atlassian. In their documentation for development panel, a red status lozenge will show “if at least one run failed for any build by any linked build server”.