Create a scan using sitemaps
Learn how to create a visual scan by adding URLs using sitemaps.
Follow these steps to create a visual scan by adding URLs from a sitemap:
Switch to visual scanner
Sign in to Percy. You can view the Percy dashboard. On the dashboard, the following options are available:
- Visual testing
-
Visual scanner
Choose Visual scanner and click the New Scan to launch the create a new scan window.
Click Add via sitemap. In the Enter domain URL or sitemap.xml URL text field, enter the URL or sitemap.xml URL and click Add sitemap.
You can see a list of pages corresponding to the domain. Click Next.
If you wish to examine changes in staging against production, you can include an additional environment in the same scan. Click Compare with alternate environment and enter the staging URL.
All URLs in the sitemap can be loaded, but a maximum of 1000 can be added to a particular scan by selecting or de-selecting URLs. By default, the first 1000 URLs are selected.
- Enter Name for the scan.
- Enable Schedule recurrent scans and provide the information for the recurrence. Learn more
- Click Create Scan.
To scan a page that requires a user authentication, add Login configuration in More settings.
Scans will begin running right away if Schedule recurrent scans is not enabled.
View Results
To review the results of the build, go to the Visual scanner dashboard and choose the project you created from the Scans page.
The page lists all the visual scans and details such as number of changes, number of pages and the scan schedule. At this point, you can examine the visual changes by clicking the individual builds. You can approve the build or request changes.
Percy automatically approves your first build and only uses approved builds as new baselines.
Even if your scans are scheduled, you can still initiate an instant scan by using the Run now option. Navigate to the scan you created and click Run now.
Integrate Slack and/or Microsoft Teams to receive notifications about the visual differences on the specified URLs.
Related topics
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
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!