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

Integrate Percy with Azure Pipelines

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

Follow these steps to integrate Percy with Azure Pipelines:

Configuring environment variables

Step 1: Add PERCY_TOKEN to your pipeline as a secret:

Start by configuring PERCY_TOKEN, our project-specific, write-only API token. It can be found in your Percy project settings and set in your pipeline’s variables as a secret. Remember to click the padlock to encrypt the variable.

In your Azure pipeline:

  1. First edit your pipeline.
  2. Click on the kebab menu and choose variables.
  3. Add a variable named PERCY_TOKEN, with the value set to the write-only token from your Percy project. This token can be found in each Percy project’s settings. Remember to click the padlock to encrypt it.
  4. Save your changes.

Step 2: Add PERCY_TOKEN to your build configuration:

Azure’s docs show how the PERCY_TOKEN secret can be added to your azure-pipelines.yml file in the env section. i.e.:

azure-pipelines.yml
Copy icon Copy snippet

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.

More information

If you’re working on a public open source project, you may want Percy to run on builds from forks of your repository. The Azure Pipelines documentation titled Validate contributions from forks will be of interest to you.

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