UI Automation Activities

Last updated Nov 18, 2025

Find Elements

UiPath.UIAutomationNext.Activities.NFindElements

Retrieves a collection of UI elements, either children, descendants or top levels, according to a specified scope and filter criteria.

This activity is compatible with Object Repository.

Windows | Cross-platform

Mode - Enables you to set the find mode of the UI elements in the collection. The following options are available:
- Find children - Find first level elements that match the filter from the indicated target/element/scope.
- Find descendants - Find all the elements that match the filter from the indicated target/element/scope.
- Find top levels - Find all the elements that match the filter from all opened applications.
Filter - XML string specifying the conditions all elements in the collection should meet. The filter is a selector. The activity searches for all the children or descendants of the target element, matching the selector.

For instance, using <webctrl tag='UL' /> would initiate a search for unordered list elements within a certain web page.

Note: If the filter condition you are using leaves out all possible elements, an empty list of elements is returned.

Options

Healing Agent mode - Configures the behavior of the Healing Agent for this activity, based on Governance or Orchestrator settings at process or job level.
- Disabled - Turns off the Healing Agent for this activity.
- Inherit job settings - Applies the settings defined in Governance or in Orchestrator at the process or job level.
- Recommendation only - Enables the Healing Agent to provide recommendations on how to fix UI automation issues on running jobs, but only if permitted by Governance or Orchestrator settings.
- Same as App/Browser - Inherits the configuration from the parent Use Application/Browser activity.

Continue on error - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

Timings

Delay before - Delay (in seconds) between the time the previous activity is completed and the time this activity begins performing any operations. The default value is 0.2 seconds. Adding a delay between activities ensures that one activity has enough time to complete before the next activity begins.
Timeout - Specify the amount of time (in seconds) to wait for the activity to be executed before throwing an error. The default value is 30 seconds.

Input/Output

Input element - The UI element on which the activity is executed, stored in an UIElement object. This field supports only UIElement objects. This object can be obtained from the Output Element property field of other UI Automation activities.
Output element - Outputs a target UI Element and stores it in a UIElement object, which can be further used to target the same element with other activities.

Output

Children - All UI children found according to the filter and scope set. The field supports only IEnumerable<UiElement> variables.

On this page