Select UI Element

The Select UI Element building block selects a value inside a desktop UI control (for example, a dropdown/combobox or a multi-select list) in an already open application window. You can select a single value, add additional values to an existing selection, or remove values from a selection by using Method together with Filter criteria.

Fully expanded, the Select UI Element block shows the following properties:

Note: The screenshot on this page uses the Elegance Design , introduced in 2025.3. If you are using an earlier version, your layout may look different.

Quick-start

1. Drag Select UI Element onto the canvas.
2. Connect the block in the flow and specify Select UI Element , then set Method and the filter settings you need (Filter and Value). Optionally set Source element, Use occurred, scrolling, and timeout-related settings.
3. Run the flow when it's ready.

Building block parameters

Parameters

• Block header : The green input connector triggers the block to start executing. The green output connector triggers when the UI element has been successfully found. You can rename the block by double-clicking the header text and typing in a new title.

• Select UI Element : Contains the locator for the UI element to select inside. Capture a locator by clicking the property and selecting Capture new element . Once set, you can edit it by clicking and selecting Edit element , or clear it by right-clicking and selecting Clear element .

• Method: Controls how selection is applied to the captured element.

  • Select: Selects a single value (default). With this option, only one value will be selected.
  • Add to selection : Adds a value to the current selection. This is used when multiple values should be selected (for example, a list of tags). You can use multiple Select UI Element blocks on the same captured element to add multiple values.
  • Remove from selection : Unselects any selected values that match the specified filter.

• Filter : Defines how the value is matched when selecting from a list-like control. The block selects the first element that matches the filter criteria.

  • No Filter: No filter expression is used.
  • Equals : Requires an exact match between Value and an entry in the control.
  • Contains : Matches when Value is contained anywhere in an entry.
  • Starts with : Matches when an entry starts with Value.
  • Ends with : Matches when an entry ends with Value .

• Value : The text used by the selected Filter option to choose what to select (or remove from selection).

• Is case sensitive : Controls whether the filter matching is case sensitive. By default, it is case insensitive.

• Found element : Contains the found UI element in the desktop application window. You can use it as a Source element in other blocks to narrow down later searches. If the element is not found, this output is empty.

• Not found : Triggers if the UI element is not found within the configured timeout behavior. If nothing is attached to this connector and the element is not found, the case ends in status Fail .

• Position found : Outputs the application canvas position where the UI element was found as X, Y coordinates, relative to the screen's top-left corner (generally 0, 0 ). In multi-screen environments, X/Y may be negative or exceed a single screen's resolution depending on where the window is located. Use the expander to work with X and Y separately. UI elements that are not visible typically report position 0, 0 .

• Area found : Outputs the application canvas position and size of the found UI element as X, Y, Width, Height , relative to the screen's top-left corner (generally 0, 0 ). In multi-screen environments, X/Y may be negative or exceed a single screen's resolution depending on where the window is located. Use the expander to work with the area's position and size and their nested sub-properties separately.

• Source element : Limits the UI element locator to work inside the provided source element, instead of searching globally. This is useful when you first capture a container (for example, a row in a table) and then select something inside that specific container.

• Use occurred : Selects which occurrence of the UI element to use if more than one match is found. Select All to iterate through all occurrences. When All is selected, Current index and Completed are shown, and the top connector triggers for each occurrence.

• Current index : Outputs the current index while iterating through all occurrences.

• Completed : Triggers when iteration through all occurrences has completed.

• Count : Outputs the total number of found UI elements that match the locator.

• Default timeout : Controls whether the block uses the default timeout from the flow settings or a custom timeout value.

• Timeout (sec) : Sets the maximum time spent searching for the UI element before giving up and triggering Not found . This field is used when Default timeout is not selected.

Note: All cases have a global timeout configured in the Settings panel. This is unrelated to the timeout of a single building block. However, a running case will automatically be cancelled if it runs for longer than the global timeout.

• Scroll to find : Controls whether the block scrolls while searching for the UI element. This can be useful when searching in scrollable content where elements are loaded asynchronously.

• Max repeats : Sets the maximum number of scroll attempts before the block stops searching.

• Amount : Sets how much scrolling is performed on each repeat.

• Delay (sec) : Sets the delay in seconds between each scroll attempt.

• Await no changes: When enabled, the block waits until there have been no changes on screen for a specified period before performing the selection operation.

  • Await Timeout: Sets the number of seconds the screen must have had no changes before proceeding.

Resources