Step Types Reference - Qaptly Docs

This is a complete reference for all available test step types in Qaptly Mobile Test Designer.

Overview

Qaptly supports 9 step types organized into three categories:

Category	Step Types
Interaction	Tap, Press, Swipe, Input, Key
Verification	Verify (UI Hierarchy, AI Structured, AI Prompt)
Control	Wait, App Launch, Close App

Interaction Steps

Tap

Taps on a specific location on the device screen.

Target Modes

Coordinate Mode

┌─────────────────────────────────┐
│ X: [0.5    ] (0-1 normalized)   │
│ Y: [0.3    ] (0-1 normalized)   │
└─────────────────────────────────┘

Coordinates are normalized (0-1 range)
(0,0) is top-left, (1,1) is bottom-right

Element Locator Mode

┌─────────────────────────────────┐
│ Strategy: [Text Contains ▼]     │
│ Value:    [Login        ]       │
└─────────────────────────────────┘

Locator strategies:

Strategy	Description
Text Contains	Element contains this text
Exact Text	Element text matches exactly
Resource ID	Match by resource ID
Class Name	Match by class name
Content Description	Match by accessibility label

Scroll Options

Auto-scroll: Scroll to find element if not visible
Scroll to top first: Reset scroll position
Max scroll attempts: 1-50 (default: 10)

Fallback Coordinates

When using element locator, optionally set fallback coordinates if locator fails.

Press

Long-press on a location for a specified duration.

Parameters

Parameter	Range	Default
Duration	500-10,000 ms	1,000 ms
Step	500 ms	-

All target options from Tap are available.

Swipe

Performs a swipe gesture from one point to another.

Parameters

┌─────────────────────────────────┐
│ Start: X1 [0.5] Y1 [0.8]        │
│ End:   X2 [0.5] Y2 [0.2]        │
│ Duration: [300] ms              │
└─────────────────────────────────┘

Parameter	Range	Default
Duration	100-5,000 ms	Varies by preset

Quick Gesture Presets

Android Presets

Preset	Description
Notification	Pull down from top-left
Quick Settings	Pull down from top-right

iOS Presets

Preset	Description
Control Center (iOS 12+)	Pull down from top-right
Control Center (iOS 11-)	Pull up from bottom
Notification Center	Pull down from top-left
Back Gesture	Swipe from left edge

Universal Presets

Preset	Description
Swipe Left	Left swipe gesture
Swipe Right	Right swipe gesture

Input

Types text into a text input field.

Parameters

┌─────────────────────────────────┐
│ Text:                           │
│ ┌─────────────────────────────┐ │
│ │ Enter your text here...    │ │
│ │ (Supports multiple lines)  │ │
│ └─────────────────────────────┘ │
└─────────────────────────────────┘

Supports multi-line text
Environment variables: {{variable_name}}

Key

Presses a device hardware key or system button.

Available Keys

Key	Description
Back	Android back button
Home	Home button
Menu	Menu/Recent apps
Volume Up	Increase volume
Volume Down	Decrease volume
Power	Power button
Enter	Enter/Submit

Verification Steps

Verify

Verifies a condition is met. Three verification methods available.

Method 1: UI Hierarchy

Verifies element existence in the UI tree. Target Configuration Same as Tap - use coordinate or element locator. Check Properties

Property	Type
Class	Text match
Text	Text match
Resource ID	Text match
Clickable	Boolean
Enabled	Boolean
Focusable	Boolean
Scrollable	Boolean
Selected	Boolean
Long Clickable	Boolean

Polling Configuration

┌─────────────────────────────────┐
│ ☑ Enable Polling                │
│ Expectation: [exists ▼]         │
│ Timeout: [15000] ms             │
│ Retry Interval: [1500] ms       │
└─────────────────────────────────┘

Retry Configuration

┌─────────────────────────────────┐
│ ☑ Enable Retry                  │
│ Max Attempts: [2]               │
│ Retry Interval: [1500] ms       │
└─────────────────────────────────┘

Method 2: AI Vision Structured

Uses Cloud Vision API to analyze screenshot structure. Workflow

Click Capture Screenshot to analyze current screen
View the Cloud VL Response (JSON)
Build conditions from the JSON response
Configure retry settings

Condition Builder Create conditions based on JSON response fields:

Field path
Operator (equals, contains, etc.)
Expected value

Method 3: AI Vision Prompt

Uses Cloud Vision API with natural language prompt. Parameters

┌─────────────────────────────────┐
│ Verification Prompt:            │
│ "Is there a login button on     │
│  the screen?"                   │
│                                 │
│ Expected Result: [true ▼]       │
│                                 │
│ Precision Mode:                 │
│ ○ Fuzzy Mode (best effort)      │
│ ● Precise Mode (stricter)       │
│                                 │
│ [Test Prompt]                   │
└─────────────────────────────────┘

Parameter	Description
Prompt	Natural language question (max 200 chars)
Expected Result	true or false
Precision Mode	Fuzzy (default) or Precise

Control Steps

Wait

Introduces a delay before the next step.

Parameters

Parameter	Range	Default
Duration	100-30,000 ms	1,000 ms
Step	100 ms	-

Use Cases

Wait for page load
Wait for animation
Wait for network response

App Launch

Launches a specific application on the device.

Parameters

┌─────────────────────────────────┐
│ Search: [____________] [🔍]     │
│ ☐ Show running apps only        │
│                                 │
│ Package Name: [com.example.app] │
│ Display Name: [Example App]     │
│ Version: [1.0.0]                │
└─────────────────────────────────┘

Launch Options

Option	Description
Clear Data	Clear app data before launch
Wait for Ready	Time to wait after launch (0-10s)
Force Restart	Force close and reopen

Error Handling

┌─────────────────────────────────┐
│ App Not Installed:              │
│   Action: [Stop ▼]              │
│                                 │
│ Launch Failed:                  │
│   Action: [Retry ▼]             │
│   Retry Count: [3]              │
│   Retry Interval: [2000] ms     │
│                                 │
│ Version Mismatch:               │
│   ☐ Enable                      │
│   Expected: [1.0.0]             │
│   Operator: [>= ▼]              │
│   Action: [Warning ▼]           │
└─────────────────────────────────┘

Close App

Closes a running application.

Parameters

┌─────────────────────────────────┐
│ App Identifier: [com.example]   │
│ [Fill from Launch]              │
│                                 │
│ ☐ Force Stop                    │
└─────────────────────────────────┘

Option	Description
Force Stop	Immediately terminate (vs graceful close)
Fill from Launch	Copy package from most recent App Launch

Common Parameters

Expected Result

All steps except Web Action support an Expected Result field for documentation:

┌─────────────────────────────────┐
│ Expected Result:                │
│ [The login button should be     │
│  visible after page loads]      │
└─────────────────────────────────┘

Delay Execution

Verification steps support delay:

┌─────────────────────────────────┐
│ Delay Execution: [0] ms         │
│ (Wait before executing step)    │
└─────────────────────────────────┘

Step Type Quick Reference

Step	Icon	Primary Parameters
Tap	👆	Target (coord/locator), UI analysis
Press	👇	Target, Duration
Swipe	👉	Start/End coords, Duration
Input	⌨️	Text content
Key	🔘	Key selection
Wait	⏱️	Duration
Verify	✅	Method, Target, Conditions
App Launch	📱	Package, Launch options, Error handling
Close App	🛑	Package, Force stop

Related:

​Overview

​Interaction Steps

​Tap

​Target Modes

​Scroll Options

​Fallback Coordinates

​Press

​Parameters

​Swipe

​Parameters

​Quick Gesture Presets

​Input

​Parameters

​Key

​Available Keys

​Verification Steps

​Verify

​Method 1: UI Hierarchy

​Method 2: AI Vision Structured

​Method 3: AI Vision Prompt

​Control Steps

​Wait

​Parameters

​Use Cases

​App Launch

​Parameters

​Close App

​Parameters

​Common Parameters

​Expected Result

​Delay Execution

​Step Type Quick Reference

Overview

Interaction Steps

Tap

Target Modes

Scroll Options

Fallback Coordinates

Press

Parameters

Swipe

Parameters

Quick Gesture Presets

Input

Parameters

Key

Available Keys

Verification Steps

Verify

Method 1: UI Hierarchy

Method 2: AI Vision Structured

Method 3: AI Vision Prompt

Control Steps

Wait

Parameters

Use Cases

App Launch

Parameters

Close App

Parameters

Common Parameters

Expected Result

Delay Execution

Step Type Quick Reference