Skip to main content

Maintaining Visual Tests Over Time

Maintaining visual tests is crucial to ensure they remain effective and relevant as your application evolves. This guide provides strategies and best practices for managing visual tests over time, handling intentional UI changes, and keeping your test suite maintainable and reliable.


The Importance of maintenance

  • Adaptation: Your application's UI will change due to new features, redesigns, or updates.
  • Accuracy: Regular maintenance ensures your visual tests accurately reflect the current state of your application.
  • Efficiency: Proactive management reduces false positives and unnecessary debugging.

Strategies for updating baselines

Baselines are the reference images used for visual comparisons. When intentional UI changes occur, you'll need to update these baselines.

1. Review changes regularly

  • Schedule reviews: Establish a routine (e.g., after each sprint) to review visual test results.
  • Collaborate: Involve developers, testers, and designers in the review process to ensure changes are intentional and acceptable.

2. Use batch approvals

  • Batch updates: When multiple tests are affected by a UI change, use batch operations in the Applitools Dashboard to approve all related changes efficiently.
  • Consistency: Ensure that all affected baselines are updated simultaneously to prevent inconsistencies.

3. Leverage version control

  • Branch-specific baselines: Utilize Applitools' branching features to manage baselines per feature branch.
  • Merge strategies: When merging branches, merge corresponding baselines to keep the main branch up-to-date.

Handling intentional UI changes

When intentional UI updates occur, it's essential to manage visual tests to reflect these changes accurately.

1. Communicate changes early

  • Design Documentation: Keep design specifications updated and accessible.
  • Team Notifications: Inform the testing team of upcoming UI changes to prepare for baseline updates.

2. Update baselines proactively

  • Pre-update baselines: Before merging UI changes into the main branch, run visual tests and update baselines accordingly.
  • Staging environments: Use staging environments to validate UI changes and update baselines before production deployment.

3. Annotate changes

  • Remarks and issues: Use the Applitools Dashboard to add remarks explaining the nature of intentional changes.
  • Change history: Maintain a log of changes for future reference.

Best practices for baseline management

Keep baselines clean and organized

  • Naming conventions: Use descriptive and consistent names for tests and baselines.
  • Archive old baselines: Remove or archive outdated baselines to reduce clutter.

Avoid over-updating baselines

  • Verify changes: Ensure that changes are indeed intentional before updating baselines.
  • Partial updates: Update only the affected areas when possible, rather than the entire baseline.

Use ignore regions wisely

  • Dynamic content: Apply ignore regions to areas with frequently changing content to reduce false positives.
  • balance: Avoid overusing ignore regions, as they may mask unintended changes.

Implementing maintenance in your workflow

Integrate with CI/CD pipelines

  • Automated testing: Run visual tests automatically during builds to catch issues early.
  • Notifications: Configure alerts for test failures to prompt timely reviews.

Establish ownership

  • Assign responsibilities: Designate team members responsible for reviewing and updating baselines.
  • Collaborative tools: Utilize tools like the Applitools Dashboard to facilitate teamwork.

Monitor test stability

  • Flaky tests: Identify and address tests that frequently fail due to environmental issues.
  • Consistent environments: Ensure testing environments are stable and consistent to reduce false positives.

Tips for long-term success

Educate the team

  • Training: Provide training on visual testing best practices and tools.
  • Guidelines: Develop documentation outlining processes for maintaining visual tests.

Regular audits

  • Review test coverage: Periodically assess which areas are being tested visually and adjust as needed.
  • Optimize performance: Remove redundant tests and focus on high-impact areas.

Stay updated with Applitools features

  • New capabilities: Keep an eye on updates to Applitools that could enhance your maintenance process.
  • Community engagement: Participate in forums or user groups to learn from others' experiences.