---
version: "2026.1.0"
language: "en"
---
# Get Mobile Text

The **Get Mobile Text** building block is used to retrieve text from a selected mobile element in an application. You can also refine what gets captured using formatting, filtering, timeout, and scrolling settings.

Fully expanded, the **Get Mobile Text** block shows the following properties:  
![image-20260127-160442.png](https://docs.leapwork.com/__attachments/a_7a069cb8ad2f6daa2db95712df76b4363178caa6cb5e4a6527a8dd9aa8172ac5/image-20260127-160442.png?cb=581fabb7889662c7aee83d60fbe46092)

**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 **Get Mobile Text** onto the canvas.

2. Set **Select Mobile Element to get text** by capturing the target element (right-click **Capture new mobile element**, or click the property to open the mobile recorder).

3. Connect its **green input** to the previous step in your flow, and connect the **success** and **Not found** outputs to the next step(s).

4. Run the flow.

## Building block parameters

Parameters  
* **Block header:** Shows the current title of the **Get Mobile Text** block. You can rename it by double-clicking the header and typing a new title. The green input connector triggers the block when the flow reaches it, and the green output connector triggers when the mobile text is found successfully.

  This parameter is **mandatory** .

* **Select Mobile Element to get text:** Defines the mobile element locator to extract text from. This parameter is **required** . You can capture the locator either by right-clicking and selecting **Capture new mobile element** , or by clicking the property to open the mobile recorder. You can clear it by right-clicking and selecting **Clear mobile element** .

* **Text found:** Outputs the text retrieved from the selected mobile element.

* **Not found:** Branches the flow when suitable text is not found within the timeout.

* **Position found:** Returns the X,Y position where the text was found. Expand the property to work with X and Y separately.

* **Area found:** Returns the X,Y position and size (Width, Height) of the area where the text was found. Expand the property to work with the values separately.

* **Find format:** Lets you define a format the text must match to be retrieved (for example, using a pattern like `Status: [TEXT] today`).

* **Is case sensitive:** Controls whether matching (for example, format matching) is case sensitive.

* **Filter:** Applies an additional condition the text must meet to be retrieved (for example, only text that *starts with* a specific value).

* **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 text before the block gives up and triggers **Not found** .

* **Scroll to find:** Controls whether the block scrolls while searching for text (useful in scrollable views)

## Resources

|                                        **Topic**                                         |                            **Description**                             |
|------------------------------------------------------------------------------------------|------------------------------------------------------------------------|
| [++Mobile connections++](https://docs.leapwork.com/leapwork-flow/latest/administration/connections.md)            | Overview of what's needed to enable mobile automation                  |
| [++Mobile configuration++](https://docs.leapwork.com/leapwork-flow/latest/administration/mobile-configuration.md) | Steps to configure devices and environments for testing                |
| [++Mobile FAQs++](https://docs.leapwork.com/faq/latest/leapwork-flow-faq/mobile-faq.md)                           | Frequently asked questions about mobile automation and troubleshooting |