---
title: "AI playback self-healing"
slug: "ai-playback-self-healing"
updated: 2026-05-20T08:34:44Z
published: 2026-05-20T08:34:44Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://success.panaya.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI playback self-healing

ScriptBuilder is equipped with a powerful self-healing mechanism. When locators fail to properly identify the target element, our smart engine can use AI for the instruction description as a fallback method, allowing it to intelligently locate the element when locators fail.

## ScriptBuilder Script Settings

This innovative approach significantly improves script stability and reduces maintenance effort by automatically adapting to UI changes.

When self-healing is activated and utilized, an ‘AI locator’ note appears for AI-passed instructions.

You can turn on or off AI playback self-healing for recording, playback, or both.

You can also set this option on or off [for each instruction](/v1/docs/ai-playback-self-healing#ai-selfhealing-configuration-at-instruction-level) separately.

![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-Z4W9XFYD.png)

## Self-healing during recording

During script recording, ScriptBuilder can use AI to rephrase instruction text to improve the chances of successful self-healing. If the suggested rephrasing is inaccurate, users can easily revert the instruction to the original recorded text. ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-AXEICXKK.png) ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-AS9A7G0B.png)

## Self-healing during playback

- When self-healing runs successfully, an indicator appears below the passed instruction.
- If identified as a resilient locator, it is added as the primary locator in the instruction's locator list.
- Sometimes, a non-resilient locator may allow the instruction to pass but will not be added to the locator list. ![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-UDY2M784.png)

## Turning instruction AI self-healing on or off

You can enable or disable AI playback self-healing for each instruction in ScriptBuilder.

Open the **instructions details** and check **‘User AI playback self-healing**’ on or off.

![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-CKA085D2.png)

![](https://cdn.document360.io/f404076c-de23-4609-848e-2dfd4ef701b0/Images/Documentation/image-CH6ESZL8.png)

> [!WARNING]
> Cannot see the AI playback self-healing option?
> 
> [Learn how to enable AI features for your Panaya subscription](/v1/docs/enabling-ai-features).