Auto-Healing Insights

Review how auto-healing behaved during a run to see which locator failed, what replaced it, and whether to keep the change. Insights open from the healed step on the results page.

Prerequisites

Before you begin, ensure that:

1. Auto-healing is enabled for the project.
2. A run has been completed in which at least one step was healed.

Identify Healed Steps in a Run

1. Open the test case results for the run.
2. Select the healed step.

Review the Heal on the Analysis Tab

The Analysis tab shows a Healed this step card explaining what happened: "Existing locator failed during execution, and we've auto-healed it using AI. The element locator was updated with a new XPath to ensure your test continues to run smoothly."

Choose one of the following:

• Click Approve as Primary to make the healed locator the locator the test uses from now on.
• Click Ignore to leave the original locator in place. The heal still applied to this run only.

View Autoheal Details

Open the Autoheal Details panel to see exactly which locator changed.

The panel shows:

• The element that was healed, named at the top.
• The prompt "Do you want to update the autohealed element in all the linked test cases?" with Update and Ignore buttons.
• The healing method and how long it took, such as "Autohealed using CSS Selector" and "32s 912ms".
• The locator that failed, struck through, followed by the locator that replaced it.

Click Update to apply the healed locator across every test case linked to the element, or Ignore to leave those test cases unchanged.

Additional Information: Use the feedback icons under "Is this autoheal helpful?" to tell us whether the heal was correct. The same feedback icons appear on the auto-healed banner above the step list.

Read the Locator Trace

Every auto-heal event records a locator trace: the full sequence the engine worked through to arrive at a heal, and whether that heal succeeded or failed.

Use the trace to understand why a particular locator was chosen, or why no replacement could be found.

Additional Information: The locator trace is provided by the Auto Heal V2 architecture.

When a Heal Fails

A heal attempt that fails gets the same root cause treatment as a failed step. Open the Root cause block on the Analysis tab and click Explain this failure to see why the engine could not resolve the element.

Fix the Locator Yourself

If you would rather not accept the healed locator, you have two alternatives:

• Update element corrects the locator directly. In the Visual Evidence section, the Element field on the current run side carries an edit icon for this.
• Relearn step re-captures the step so a fresh locator is recorded.