Bitbucket Cloud

Install the 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.

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

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

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.

Clicking the Percy status in Bitbucket will take you to the Percy build UI, showing all visual diffs to be reviewed. Approving a build in Percy sets the 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 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.