Skip to main content
Transform your testing process with: Company-wide Licences, Test Observability & App Percy

Integrate Percy with Bitbucket Pipelines

Integrate Percy with Bitbucket Pipelines, a popular CI-CD tool

Follow these steps to integrate Percy with Bitbucket Pipelines:

Configuring environment variables

Start by configuring PERCY_TOKEN, our project-specific, write-only API token. It can be found in your Percy project settings and set via your Bitbucket Pipelines settings.

Bitbucket Pipelines provide a variety of ways to configure environment variables. Because each Percy project is usually associated with just one repository, we recommend setting PERCY_TOKEN up as a repository variable, and making it secure.

In your Bitbucket project, go to Settings > Pipelines > Respository Variables.

Then set PERCY_TOKEN to the write-only token from your Percy project. The token value can be found in each Percy project’s settings.

Percy Token - Bitbucket Pipeline

Keep your Percy token secret.

Anyone with access to your Percy token can add builds to your project, though they cannot read data. If your code is public, do not commit the PERCY_TOKEN to your code.

For Bitbucket Pipelines, make sure the “Secure” checkbox is checked.

With the addition of the PERCY_TOKEN repository variable, any snapshots you take in this pipeline will be sent to the associated Percy project. Percy will automatically detect the commit SHA, branch name, and pull request number from the Pipelines environment.

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