Skip to main content
No Result Found

Bitbucket Cloud

The App Percy Bitbucket integration makes it easier to sync visual reviews with code reviews. Once installed, App Percy will be able to automatically pull in metadata from pull requests to builds, and post status updates to Bitbucket Cloud repositories. This integration also helps us provide more relevant snapshot comparisons through smarter base build selection.

Install the App Percy Bitbucket integration
Navigate to your Organization Settings > Integrations. Click Install to add Bitbucket. When you click Install Bitbucket Cloud App, you’ll be directed to Bitbucket for authentication.

Install Bitbucket Cloud App

Granting App Percy access to your Bitbucket account will allow you to link projects to any repository you have admin access to in Bitbucket.

Select a Bitbucket account

Link App Percy projects and Bitbucket repositories
Once you’ve granted access, you’ll need to link your App Percy projects to your Bitbucket repositories.

Linked projects

App Percy projects can also be linked to Bitbucket repositories from the Project’s settings page, in the Link a repository section.

Run and review builds
Once you’ve added the app, linked projects with repositories, and created a PR, ensure to trigger visual tests in your CI server to run alongside your integration tests. This ensures that subsequent Percy builds display metadata from Bitbucket. Percy automatically updates the Bitbucket pull request summary if there are visual differences waiting for review.

Builds

Clicking the App Percy status in Bitbucket will take you to the App Percy build UI, showing all visual diffs to be reviewed. Approving a build in App Percy sets the App Percy status in Bitbucket to successful, so that your team can see that visual changes were reviewed and approved.

Troubleshooting
If you find your integration is not working as expected, check the integration logs on the Bitbucket integration page. These can be found by selecting Edit settings under Organization Settings > Integrations. The logs table will show you all the communication App Percy has recently had with Bitbucket. If there is not a recent log line, you can click the Run health check button to create a new log from Bitbucket.

Integration Logs

Next step

Learn about our additional workflow features like snapshot carryforward, auto-approved branches, baseline picking, and more.

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback!

Talk to an Expert
Download Copy Check Circle