# Find Elements

> `UiPath.UIAutomationNext.Activities.NFindElements`

`UiPath.UIAutomationNext.Activities.NFindElements`

## Description

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.

## Project compatibility

**Windows** | **Cross-platform**

## Configuration

* **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.
  :::

### Properties panel

#### 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.