Hey! These docs are for version 1, which is no longer officially supported. Click here for the latest version, 2-web!


Configure Percy environment variables in Drone

Percy is designed to integrate with your tests and CI environment. To enable Percy, the token environment variable must be configured in your CI service:

  • PERCY_TOKEN: The Percy repo write-only API token. This is unique for each Percy repository.

Drone project setup

Drone provides an easy way to set environment variables in the .drone.yml config:


In your .drone.yml, add a section for environment variables and set PERCY_TOKEN to the write-only token from your Percy repo. This token can be found in each Percy repo's settings.

    - PERCY_TOKEN=aaabbbcccdddeeefff


IMPORTANT: Keep your Percy token secret. Anyone with access to your token can consume your account quota, though they cannot read data.

If your code is public, do not commit the PERCY_TOKEN to your code.

Next step: integrate with tests

You're done with setup---the last step is to integrate Percy into your tests and run them. Just choose your client library:




Static sites

Everything else