Find Mobile Image

The Find Mobile Image block is used to search for a specific image on the screen of a mobile application as part of a mobile automation flow. It is typically used to validate that the app is in the expected visual state or that a particular icon, banner, or message is present before the flow continues.

Fully expanded, the Find Mobile Image 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 Find Mobile Image onto the canvas.
2. Connect the block in the flow and capture the reference image in Select Mobile Image; optionally adjust Timeout (sec), Scroll to find, and Await not found.
3. Run the flow when it's ready and use Found element or Not found to guide the next steps.

Building block parameters

Parameters

• Block header: Displays the current name of the Find Mobile Image block. You can rename it by double-clicking the header and typing a new title. The green input connector starts the search when the flow reaches this block, and the green output connector triggers when the mobile image has been found.

• Select Mobile Image: Holds the reference image to search for on the device screen.

  • Capture the image from the mobile device and store it here.
  • Right-click and select Clear collection to remove the current image or image collection. The captured image acts as the template that is matched during execution.

• Found element: Contains the mobile image found in the application. You can pass this as a source image to other blocks that work with image results.

• Not found: Green output connector that triggers if the mobile image is not located before the timeout. This is typically used to branch the flow or explicitly fail the case with a Fail block.

• Position found: The position where the mobile image was found, expressed as X and Y coordinates within the application. You can expand this property to work with the coordinates separately.

• Area found: The position and size of the found mobile image as X, Y, Width, and Height coordinates. Expanding this property lets you work with the area's position and size and their nested sub-properties individually.

• Default timeout: Controls how the timeout is applied:

  • When the checkbox is unchecked, you can specify a custom value in Timeout (sec), and the default of 60 seconds is used unless you change it.
  • When the checkbox is checked, the block uses the Default timeout value defined in the flow settings.

• Timeout (sec): Sets the maximum time spent searching for the mobile image before giving up and triggering Not found. This timeout is specific to the block. All cases also have a separate global timeout configured in the Settings panel; if the case runs longer than that value, it is cancelled even if this block's timeout has not been reached.

• Scroll to find: Defines whether the block should scroll while searching for the image. Options include:

  • None: no scrolling is performed.
  • Down: scrolls down while searching.
  • Up: scrolls up while searching. This is useful when looking for images in scrollable content where elements may only appear after scrolling.

• Max repeats: Specifies the maximum number of scroll operations to perform when Scroll to find is set to Up or Down. After this number of attempts, the search stops even if the image has not been found.

• Await not found: When selected, the block assumes the mobile image is currently present and waits until it can no longer be found on the screen before continuing. This is useful, for example, when you want to proceed only after a "Loading" indicator or temporary message has disappeared.

Resources