Self healing for manual xpath

Dear Katalon Community,

I am reaching out to inquire about the self-healing capabilities of Katalon, specifically regarding manual XPath locators.

I understand that Katalon offers self-healing features for identifying and updating object locators automatically while record and play when they become invalid. However, I am curious to know if this functionality extends to manual XPath expressions that we define ourselves.

If self-healing is possible for manual XPath, could you please share how this can be achieved? Any guidance or resources you could provide would be greatly appreciated.

1 Like

Katalon’s self-healing capabilities mainly focus on auto-generated locators during recording. Unfortunately, self-healing does not directly apply to manually defined XPath expressions.

However, you can still enable self-healing for objects that have both an auto-generated locator and a manually defined XPath. Here’s how to make it work:

  1. Add Multiple Locator Strategies: Define the manual XPath alongside other locator strategies (e.g., attributes or CSS) in the object properties. Katalon will try alternative strategies if one fails.
  2. Enable Self-Healing Mode: Make sure self-healing is enabled in Katalon Studio (Project → Settings → Self-Healing).
  3. Monitor Self-Healing Reports: If the primary manual XPath fails, Katalon will attempt the alternative locators and log the changes in the self-healing reports.

For manual XPath specifically, you’ll need to update them manually if they become invalid. The self-healing feature works best when multiple locator options are available.

Take These Important Note :

Self-healing only works if you are currently working on a WebUI project and using the Katalon Studio Enterprise version. I hope this solution helps you.

1 Like