---
version: "2026.1.0"
language: "en"
---
# Start Mobile Application

The **Start Mobile Application** block is used to start a mobile app on a connected device. It identifies and launches the application by its bundle ID and allows dynamic input using tokens.

The block waits for the app to open and can fail gracefully if the application does not start within the specified timeout.

Fully expanded, the **Start Mobile Application** block shows the following properties:  
![image-20251112-131600.png](https://docs.leapwork.com/__attachments/a_9449544c86f93578bb9685d96e533e6ecc729f3b988e7c0fbdf7170b8175354d/image-20251112-131600.png?cb=d98894063864d38045fcbe479c5d6566)

**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 **Start Mobile Application** onto the canvas.

2. Specify the basic parameters required for this block to operate: **Bundle Id, Default timeout, Timeout**.

3. Run the flow when it's ready.

## Building block parameters

Parameters  
* **The Block Header:** The green input connector in the header is used to trigger the block to start executing. The green output connector in the header triggers when the mobile application has been successfully started. The title of the block ("Start Mobile Application") can be changed by double-clicking on it and typing in a new title.

<!-- -->

* **Bundle Id:** The unique identifier for the mobile application to be launched. Typically uses a string such as `com.example.myapp`. Supports tokens from **Text fields** for dynamic selection.

* **Text fields:** Enables the use of dynamic values in the *Bundle Id* field. Right-click the *Bundle Id* field to insert tokens referencing these fields. Fields can be renamed, and tokens will update automatically.

* **Error occurred:** Triggers if the application cannot be started within the specified timeout. This output can be used to branch the flow for error handling.

* **Default timeout:** Defines whether the global flow timeout setting should be used. If unchecked, the local timeout value (below) is used instead.

* **Timeout:** Maximum wait time in seconds to start the application. Default value is 60 seconds. If exceeded, the *Error occurred* output is triggered.

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