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

**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) | Overview of what’s needed to enable mobile automation |
| [Mobile configuration](https://docs.leapwork.com/leapwork-flow/latest/administration/mobile-configuration) | Steps to configure devices and environments for testing |
| [Mobile FAQs](https://docs.leapwork.com/faq/latest/leapwork-flow-faq/mobile-faq) | Frequently asked questions about mobile automation and troubleshooting |