Skip to main content

Device passcode

The Passcode desired capability allows you to test mobile applications that require a a device passcode as part of their security or authentication flow. You can test the following scenarios with this feature:

  • The device has a passcode.
  • App features that require you to enter the device passcode.

In this guide, you'll learn about the supported devices and how to enable the passcode capability.

Supported devices

You can test device passcode with TestCloud private and public devices.

Private devices

Private devices are the devices with the UDID. For more details, refer to Use TestCloud private mobile devices.

Private device in Katalon Studio

Public devices

  • Android devices: Available for real devices running on Android 11 and above.
  • iOS devices: Refer to the table below.
DeviceOS version
iPhone 1726
iPhone 17 Pro26
iPhone 17 Pro Max26
iPhone Air26
iPhone 16 Pro26
iPhone 15 Plus26
iPhone 13 Pro26
iPhone 16 Pro18
iPhone 1618
iPhone 15 Pro17
iPhone 1517
iPhone 1416
iPhone 1315
iPad Air 11 (2024)18
iPad 11 (2025)18

Enable passcode capability

  1. In Katalon Studio, go to Project > Settings > Desired Capabilities and select TestCloud.
  2. In the TestCloud settings table, add the katalon:options property and set the Type as Dictionary.
  3. Set the passcode capability according to the type of device you're testing with:
    1. For private devices: In the Value column, add the passcode capability with String type, then provide a 6-digit number as your passcode value.
    Select test suites/test suite collections
    1. For public devices: In the Value column, add the enablePasscode capability with Boolean value type and set it as true.
    Select test suites/test suite collections
Was this page helpful?