Skip to main content

Prerequisites

Before creating a workflow, ensure you have:
  • ✅ At least one test created
  • ✅ Tests are in a working state (not broken)
  • ✅ Access to the Workflows page
If you don’t have any tests yet, create one first by following the Creating a Test guide.

Step 1: Navigate to Workflows

  1. Click Workflows in the sidebar
  2. You’ll see the Workflows page
If this is your first workflow, you’ll see an empty state: Workflows empty state

Step 2: Open the Create Workflow Dialog

Click the Create Workflow button (either in the empty state or in the top-right corner). The “Create New Workflow” dialog will appear: Create workflow dialog

Step 3: Name Your Workflow

Enter a descriptive name in the Workflow Name field.

Naming Best Practices

Good names:
  • ✅ “Daily Notes App Testing”
  • ✅ “Smoke Tests - Android”
  • ✅ “Critical User Flows”
  • ✅ “Pre-Release Regression”
Avoid:
  • ❌ “Workflow 1”
  • ❌ “Test”
  • ❌ “My Workflow”
Include the platform, frequency, or feature area in the name to make it easy to identify the workflow’s purpose at a glance.

Step 4: Select Tests

The dialog shows a Test Selection section with:
  • Search box - Find tests by name
  • Platform filter - Filter by Android or iOS
  • Tags filter - Filter by test tags (if you’ve added any)
  • Available Tests list - All tests matching your filters

Selecting Tests

  1. Browse the Available Tests list
  2. Check the checkbox next to each test you want to include
  3. Selected tests appear at the bottom with a count (e.g., “Selected (1/3)“)
Workflow dialog with test selected

Test Selection Tips

  • You can select tests from different platforms (Android and iOS)
  • You can select tests using different builds
  • Use the search box to quickly find tests by name
  • Selected tests show a checkmark
  • Click Clear All to deselect all tests

How Many Tests to Include?

Best for:
  • Smoke tests
  • Critical path validation
  • Quick sanity checks
Best for: - Feature-specific testing - Platform-specific regression - Daily automated runs
Best for:
  • Full regression suites
  • Pre-release validation
  • Weekly comprehensive testing

Step 5: Create the Workflow

Once you’ve:
  • ✅ Entered a workflow name
  • ✅ Selected at least one test
The Create Workflow button will become enabled. Click Create Workflow to finalize.

Step 6: Success!

You’ll see a success notification and be redirected to the Workflows page. Your new workflow will appear in the list: Workflows page with new workflow The workflow card shows:
  • Workflow name
  • Status: “Not Run” (since it hasn’t been executed yet)
  • Test count: e.g., “1 test”
  • Last run: “Never”
  • Duration: Not shown until the workflow has a completed run

What Happens Next?

After creating a workflow, you can:

1. Run It Immediately

Click the Run button (▶) on the workflow card to execute it right away.

2. Configure It

Click the workflow card to open the details page where you can:
  • Add or remove tests
  • View execution history
  • Set up integrations
See Configuring Workflows for details.

Next Steps


Need help? Contact [email protected]