Skip to main content
The Macro Manager allows you to create, edit, and manage reusable test automation macros that can be applied across multiple test cases.

Overview

Macros are reusable sequences of test steps that:
  • Reduce repetitive work
  • Ensure consistency across tests
  • Speed up test case creation
  • Simplify maintenance

Accessing Macro Manager

From Remote Test Manager

  1. Open the Remote Test Manager
  2. Click the Settings (⚙️) button
  3. Select Macro Manager

From Mobile Test Designer

  1. In the step editor
  2. Click Insert Macro
  3. Browse and select macros

Interface Layout

Browsing Macros

Platform Filter

Filter macros by platform:
  • All: Show all macros
  • Web: Web application macros
  • iOS: iOS-specific macros
  • Android: Android-specific macros
  • Mobile: Both iOS and Android
  • API: API testing macros
  1. Enter search text in the search box
  2. Search matches:
    • Macro name
    • Macro description
  3. Click 🔍 or press Enter to search

Macro List

The list displays:

Creating a Macro

Step 1: Click New Macro

Click the [+ New Macro] button.

Step 2: Configure Macro

  1. Name: Enter a descriptive name
  2. Description: Explain what the macro does
  3. Platform: Select target platform(s)

Step 3: Define Steps

Add steps to the macro:
  1. Click Add Step
  2. Configure step type (tap, swipe, input, etc.)
  3. Set step parameters
  4. Repeat for additional steps

Step 4: Save

Click Save to create the macro.

Macro Step Types

Macros support the same step types as test cases: See Step Types Reference for details.

Editing Macros

Modify Existing Macro

  1. Find the macro in the list
  2. Click the Edit button
  3. Make changes to name, description, or steps
  4. Click Save

Duplicate Macro

  1. Select the macro
  2. Click Duplicate
  3. Modify the copy as needed
  4. Save with a new name

Deleting Macros

Delete a Macro

  1. Select the macro
  2. Click Delete
  3. Confirm the deletion
Warning: Deleting a macro may affect test cases that use it. Review usage before deleting.

Using Macros in Test Cases

In Mobile Test Designer

  1. Open a test case in Mobile Test Designer
  2. Position cursor where you want to insert
  3. Click Insert Macro
  4. Select the macro
  5. Steps are added to your test case

Macro Expansion

When a macro is inserted:
  • All macro steps are copied to the test case
  • Steps become part of the test case
  • Changes to the macro don’t affect already-inserted steps

Best Practices

Naming Conventions

  • Use descriptive names: “Login with Valid Credentials”
  • Include platform if specific: “iOS Login Flow”
  • Avoid abbreviations unless standard

When to Use Macros

  • Login/Logout flows: Common across many tests
  • Navigation sequences: Opening specific screens
  • Data setup: Creating test data
  • Verification patterns: Standard checks

Maintenance Tips

  1. Document macros with descriptions
  2. Keep macros focused and atomic
  3. Review and update regularly
  4. Remove unused macros

Related: