Failure reason management

Failure reasons help you classify why a test failed so you can analyze trends, triage faster, and improve test stability. Perfecto provides predefined categories and reasons, and lets administrators add a small set of custom reasons that map to those categories. Colors and IDs make reasons easy to identify in reports and Insights.

Use failure reasons to standardize test failure classification across your organization. The Failure reasons tab (in Assets and Setup) lists predefined reasons (marked with the Perfecto logo) and provides tools to add, edit, or delete custom reasons that your team needs. Blocked failure reasons are system-generated insights about why test execution could not complete. They are visible in reports but are not configurable.

Prerequisites

  • User with Admin role (the Failure reasons tab is available only to admin users)

  • Access to your cloud at https://<cloud-name>.app.perfectomobile.com

Limitations

  • You cannot rename predefined (system‑supplied) failure reasons. You can change their color only.

  • Blocked failure reasons do not appear in the Failure reasons list and cannot be configured.

  • You can add up to 15 custom failure reasons. Perfecto assigns a unique ID to each.

  • Changing a reason’s color or editing a custom reason does not retroactively update already‑categorized test reports.

  • The failure reason ID in code must match a defined reason. Mismatches are ignored.

In this section