KB-2436 XPath and HTML Attribute Changes After Maintenance Window

Symptoms

XPath locators and/or class attributes for Appian components (e.g., Button Component) changed following a Maintenance Window, causing automation scripts using custom XPath selectors to no longer function correctly.

Cause

• Code changes that may result in HTML changes will often be documented in the Release Notes page or the Hotfixes pages for an Appian version, however, HTML is subject to change at any time and may not always be outlined in these sections.
• Appian only supports the automated testing tools Fitnesse, Cucumber, and Selenium. We do not have insight into the functionality of other automated testing tools and so issues and results with those tools are outside the scope of Appian Support.

Action

Migrate automation scripts to one of Appian's officially supported testing frameworks: Appian Selenium API, Fitnesse for Appian, or Cucumber for Appian. These tools are actively maintained by Appian and updated to account for underlying structural changes. Reference: Testing Applications

Product Enhancement #6190 requests improved visibility of HTML attribute changes in release notes and hotfix documentation. This product use case has been logged to the Appian Product Team for consideration. Please create a Support Case referencing #6190 to request your account be added to this Enhancement Request. Kindly note it is not Appian Support's policy to disclose how or when a product use case will be implemented.

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: November 2026.