Skip to main content

Schedule test runs in TestOps


Schedule test runs

Follow these steps on how to schedule Test Runs in TestOps.
  1. Go to your Project and select the Executions tab.

    The Test Run Calendar page appears as shown below:

    test run calendar

  2. Click Schedule Test Run.

    The Schedule Test Run dialog appears as shown below:

    schedule test run dialog

  3. Enter a name for the test run, then select your repository from the Script Repository drop-down.
  4. Choose the execution type:
    • Test Suite: Run a test suite available in the script repository.

    • Test Suite Collection: Run a test suit collection available in the script repository.

    • Katalon Command: Execute tests with Katalon Studio. To generate a command, see Command Syntax and Command Builder.

    • Generic Command: Execute tests with other frameworks outside Katalon Studio (e.g., Pytest).


    To apply visual testing in your tests, see: TestOps Visual Testing.

  5. In the Environment section, click on the drop-down menu and select from the suggested environments.
    1. If you want to select other environments, click on More options .
      Choose among Local Test Environment, TestCloud Test Environment, Kubernetes Test Environment, or CircleCI Test Environment.
    2. When you finish, click Save.
  6. By default, the execution is triggered once.
    If you want the test to run periodically, toggle on Repeat and set the End date and the interval you want to run the tests, then click Schedule.

  7. If you want to save the configuration without running tests, click the drop-down arrow, then select Save Configuration.

    You can come back another time to run tests manually. See: Execute test run manually.

Advanced settings

You can optimize your configurations in the Advanced settings section of the Schedule Test Run dialog.

When you open the Schedule Test Run dialog, at the bottom left corner, click Advanced settings.

Schedule test run advanced settings

The dialog displays with the following settings:

  • Visual Testing: select a Baseline Collection ID or generate a new Baseline Collection to compare with the captured images.

  • Katalon Runtime Engine Version: select a Katalon Runtime Engine version to run your test. With Latest version, the test scheduler will select the highest version that supports your test environment.

  • Execution Mode: choose between Sequential (run one test after another) or Parallel (run tests at the same time). See: Run multiple Test Suites in parallel with Agents.

    • You can only run test suites in a sequential mode. If you choose Test Suite, there is no Parallel option.
  • Integration:
  • Custom Field & Tag: assign custom fields and tags to your test run schedule. See: Custom Fields and Tags.

  • Release Version: select the release version you want to link your test runs to. See: Manage Test Runs by Release.

  • Timeout in Minutes: define the time after which test execution is canceled. Add more minutes to this limit to avoid test executions getting timed out before completion.

After creating the schedule, Katalon TestOps automatically directs you to the Test Run List page.

The Test Run List page shows you a collection of Test Runs with the same configurations (Test Environment, Script Repository).

View test run types in Katalon Studio

  • This feature is available from Katalon Studio version 7.9.1 onwards.
  • You have enabled TestOps integration in Katalon Studio. See: Katalon Studio Integration.
The Test Run List in TestOps is equivalent to the Test Run Types in Katalon Studio.

Follows these steps:

  1. Open your project in Katalon Studio.
  2. In the Tests Explorer sidebar, go to TestOps > Test Run Types.
    You can view a summary of Test Run Types that have been configured in TestOps.

  3. Click on one of the Test Run names. This opens the Test Runs Summary page in Katalon TestOps.
You've successfully viewed the test run types.

Trigger test runs manually

You can execute test runs one time or regularly by configuring a schedule for test runs. See: Schedule Test Runs.

You can also trigger an existing test run by following these steps:

  1. In your TestOps Project, go to Executions > Schedules.

  2. Click on the Run icon to trigger the test run.

    TestOps Schedules list