---
version: "2026.1.0"
language: "en"
---
# Mobile Configuration

Once a [connection](https://docs.leapwork.com/leapwork-flow/latest/administration/connections.md) is established, the **Mobile Configurations** tab allows administrators to add and manage mobile devices (phones, tablets, etc.) for automation.  
**Note:** You must define a [connection](https://docs.leapwork.com/leapwork-flow/latest/administration/connections.md) before adding any mobile devices. Only administrators can access Mobile Configuration settings.  
![image-20260313-144006.png](https://docs.leapwork.com/__attachments/a_3a30edd7511ab939092f03e4a180626e2a2f4d4a4ea14cf31a646b64ba4966fc/image-20260313-144006.png?cb=e0ccbe9796efbb443238595d32dfae60)

Leapwork supports two mobile configuration types:

* iOS Device

* Android Device

**Note:** If you're using an Appium server connection, ensure all devices are also registered on the Appium server before adding them to Leapwork.

## iOS Device Configuration:

1. In the **Mobile Configurations** tab, click **Add**.

2. Enter a unique **Title** and a brief **Description**.

![image-20260123-113223.png](https://docs.leapwork.com/__attachments/a_b9eb6c25371657a4d5b70cc5c50978f8b4efea9beff08280364bb8eb238e0e04/image-20260123-113223.png?cb=b7c3d2a173f59efe3b37e434903d5471)

3. Click **Add** next to **Mobile** to open the configuration form.

![image-20260123-113248.png](https://docs.leapwork.com/__attachments/a_0fbba457f2858df2362da2bfb5a3fb2344d7eee5f130a5e47b544aa8ec779b57/image-20260123-113248.png?cb=795a0a79cb2e5b509df31bda511079c5)

4. Fill in the fields:

   1. **Cloud connection**: Select the desired connection.

   2. **OS type** : Choose the operating system. This information is available on either the physical device or the HeadSpin device information.

   3. **Device name**: Enter a name for the device.

   4. **Platform version** : Specify the OS version. This information is available on either the physical device or the HeadSpin device information.

   5. **UDID** : Enter the [device's UDID](https://support.leapwork.com/s/article/How-to-obtain-Udid-in-Appium).

   6. **XcodeOrgId** and **XcodeSigningId**: Retrieve these from your Apple Developer account.

   7. **Capturing type**:

      * **Screenshot**: Captures screenshots per block. Recommended for most use cases.

      * **Streaming** : Captures full-frame video. Requires more bandwidth and storage.

        ![image-20260123-113316.png](/__attachments/a_f1d547b2413e5ec50bbcb9004f0b4b61cb60ab5516268299792ff0643695ec6f/image-20260123-113316.png?cb=1f1ebebaa224cd40f9ddad2d4b3cd1f5)

5. Click **Test configuration** to verify the setup.

![image-20260123-113332.png](https://docs.leapwork.com/__attachments/a_a1613539b8f0d077ed13072301f3043c8bdf4bed485ce066a8b24bed2b6d5d7b/image-20260123-113332.png?cb=fd774b074c4721b82c8b840e2433c07f)

6. Click **Apply** to register the changes.

7. Click **Save**.

A confirmation message appears and the new configuration is listed under **Mobile**.  
![image-20260123-113409.png](https://docs.leapwork.com/__attachments/a_564253cd585b10f634f3565499a8b7b7d8f23f04af47b1eeb9a44282c125b1a5/image-20260123-113409.png?cb=52347d9b726ce56e473ceb6905e92d07)

## Android Device Configuration

1. Open the **Mobile Configurations** tab and click **Add**.

![image-20260123-113437.png](https://docs.leapwork.com/__attachments/a_f6110cf1688950171011d8adbc874b9eb161e5f54cf8758ea3bb5aeebb25a4da/image-20260123-113437.png?cb=3b46d773783346765159cd203893bcc2)

2. Provide a unique **Title** and a short **Description**.

3. Click **Add** next to **Mobile** to open the configuration form.

![image-20260123-113503.png](https://docs.leapwork.com/__attachments/a_4c1205b090e7a4bee3b4699d9f71fd97837dbbe8d578b523517d5a43f7a0217c/image-20260123-113503.png?cb=982286dc89d777bd2ed075e9fe85f8cc)

4. Fill in the fields:

   1. **Cloud connection**: Select the desired connection.

   2. **OS type** : Choose the operating system. This information is available on either the physical device or the HeadSpin device information.

   3. **Device name**: Enter a name for the device.

   4. **Platform version** : Specify the OS version. This information is available on either the physical device or the HeadSpin device information.

   5. **UDID** :se the command `adb devices` in the terminal to retrieve it.

   6. **Capturing type**:

      * **Screenshot**: Captures screenshots by block. Recommended for most cases.

      * **Streaming** : Captures full-frame video. Requires more bandwidth and storage.

        ![https://www.leapwork.com/hs-fs/hubfs/image-png-Mar-07-2023-06-19-19-8007-AM.png?width=492&height=102&name=image-png-Mar-07-2023-06-19-19-8007-AM.png](https://www.leapwork.com/hs-fs/hubfs/image-png-Mar-07-2023-06-19-19-8007-AM.png?width=492&height=102&name=image-png-Mar-07-2023-06-19-19-8007-AM.png)

5. Click **Test configuration**to verify the setup.

![image-20260123-113540.png](https://docs.leapwork.com/__attachments/a_988ded2f108ef448481a84449022434585bdc861ec8e762af9b34c780c63648e/image-20260123-113540.png?cb=cbe47d36b590a49dd6562017ea151b8e)

6. Click **Apply** to register the changes.

7. Click **Save**.

A confirmation message appears and the new configuration is listed under **Mobile**.  
![image-20260123-113617.png](https://docs.leapwork.com/__attachments/a_f8eb3e3ebbf9b7728dd8a5a7b733acbe25151f2e4688a117f8fb75c2d47e2ec5/image-20260123-113617.png?cb=bbbbd62cc4681609402ec4b420d28996)

To edit or delete a configuration, use the **Edit** or **Delete** buttons beside the mobile device entry.  
![image-png-Mar-07-2023-06-21-24-2967-AM.png?width=1077&height=290&name=image-png-Mar-07-2023-06-21-24-2967-AM.png](https://docs.leapwork.com/__attachments/a_3e88de711cc54b19f344926736c106af87e80402ee26531c7d462905c518d79d/image-png-Mar-07-2023-06-21-24-2967-AM.png%3Fwidth=1077&height=290&name=image-png-Mar-07-2023-06-21-24-2967-AM.png?cb=28176d6ed4de6b0e07cb981986f34748)