Skip to main content

Multiple Projects Per Repo

Learn how to configure multiple projects per repository

Percy supports having multiple Percy projects associated with one repository. This is particularly useful when you organize your code in a mono-repo, or have different types of test suites, static sites, or storybooks in one repository.

When projects are configured this way, each project will report its status individually on a GitHub pull request or GitLab merge request.

Configuring multiple projects per repository

This section assumes that you have one CI script that runs all tests in your repo. Ensure you run a full set of snapshots for each project on every master-branch build, to keep your baseline snapshots up-to-date with your latest code.

  • Visit the Percy settings page for your projects, and ensure they’re all linked to the same repository.
  • Update your CI system’s environment variables to include the PERCY_TOKEN for each project, each with a different environment variable name. i.e. PERCY_TOKEN_PROJECT_A=... and PERCY_TOKEN_PROJECT_B=...
  • Update your CI script to set PERCY_TOKEN to the correct value when the appropriate step is executed, by wrapping the environment variable’s name in ${...}.

For example, your CI script that sends snapshots to 2 different projects may look like this:

Copy icon Copy snippet

If you have questions about associating multiple projects with one repository, please feel free to contact support.

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