Real-time Percy build status in Jira.
End of Life Announcement
We are announcing the End of Life for the Percy for Jira app.
We will be retiring this app effective 1st May 2026.
During this period, we will be complying with Atlassian’s app retirement guide.
We would like to take the opportunity to thank all our users for the support they have shown for this app.
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)
-
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.
-
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”.
