Create labels

Learn how to use labels to organize projects, builds, and snapshots.

Labels/Tags are essential for categorizing and organizing projects, builds and snapshots. They improve the ability to filter and search for specific builds and snapshots, enhancing overall project management. By using labels/tags, teams streamline workflows, facilitate better tracking and management, and enhance collaboration, ensuring everyone stays on the same page.

Create project labels/tags

You can create project labels/tags while setting up a App Percy project. Navigate to Create Project, select the type of project, enter the name and add your own label/tags or choose from the available options.

Once the build is generated, you will see the added labels/tags in your build on the Projects page.

Create builds with labels/tags

You can create new builds with labels/tags using the --labels option in Percy CLI commands. Add multiple labels/tags by separating them with commas. To include spaces in labels/tags, use double quotes.

Example CLI command:

Example with multi-word labels/tags:

Defining labels/tags in Percy configuration file

Labels/Tags can also be defined in the Percy configuration file (percy.yml) under the percy key using the labels key.

Example percy.yml file:

Associating snapshots with labels/tags

You can associate snapshots with labels/tags by utilizing the percySnapshot or percyScreenshot functions and including the labels/tags as a key in the options parameter.

Example:

This enables you to effectively manage and filter your snapshots and builds using labels/tags, improving organization and workflow efficiency.

Search using labels/tags

The Projects and Builds pages now include a newly introduced search text box that enables you to search using labels/tags. Additonally, you can search snapshots using labels and names for individual snapshots on the review page by clicking the search icon.

• Clicking the search text box will automatically populate a dropdown menu with all valid labels/tags used across the organization, including those in projects, builds, and snapshots.
• You can select one or more labels/tags and optionally add a search term to search within the project, build or snapshot name on those pages.