> For the complete documentation index, see [llms.txt](https://docs.avoautomation.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avoautomation.com/avo-assure/working-with-the-avo-assure-platform/create-and-execute-tests-with-design-studio/working-with-element-repository-section/understanding-self-healing.md).

# Understanding Self Healing

Avo Assure's next-generation Self Heal uses AI-based heuristic matching to capture contextual fingerprints and understand the UI during test execution and intelligently identify elements on the screen. Unlike traditional approaches that depend on locator-based identification captured during script creation, it can seamlessly adapt to many UI changes without requiring updates to the test script.

This advanced self healing capability goes beyond simply switching to alternative element properties or locator strategies. By leveraging the contextual fingerprints of UI elements, it helps recover from UI changes more effectively, reducing test maintenance effort, improving automation stability, and enabling faster release cycles. 

### Prerequisites (For scripts built before Avo Assure v26.4.2) 

Following are the prerequisites to perform self healing: 

* For existing elements, test cases must consistently pass. 
* For each element, at least one locator (preferably P1) should accurately identify the correct element. 

### Scope 

* Currently, it works only via Execution lists (not in debug) and runs in the background with no UI changes in Avo Assure. 
* Only Web applications are supported. 

### Self Healing Recovery Scenarios Inclusions 

Following UI changes are handled when self heal is enabled:  

* Element ID  
* Name attribute  
* Class name  
* CSS selector  
* in XPath  
* Relative XPath  
* Layout  
* Element relocation within a page  
* Iframe and nested Iframe elements 

{% hint style="info" %}
**Note:** Any scenario outside this scope is not supported currently.
{% endhint %}

This document includes:

* [Applying Self Healing](/avo-assure/working-with-the-avo-assure-platform/create-and-execute-tests-with-design-studio/working-with-element-repository-section/understanding-self-healing/applying-self-healing.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avoautomation.com/avo-assure/working-with-the-avo-assure-platform/create-and-execute-tests-with-design-studio/working-with-element-repository-section/understanding-self-healing.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.