Skip to main content
Version: current

Execute dynamic test suites in Katalon Studio

This guide shows you how to execute a dynamic test suite in Katalon Studio.

Modify execution information of a dynamic test suite

Before executing a dynamic test suite, you might want to modify the execution information, including timeout, retry, and email recipient list for test execution reports.

You can specify additional configurations for test suite execution by expanding the Execution Information section.

Open the execution information

Implicit timeout

In the Implicit timeout section, you can decide the timeout period. This is how long Katalon Studio waits for a page to load. Choose one of the following options:

Set implicit timeout

OptionsDescription
Use defaultUse the predefined value set in Project > Settings > Execution > Default wait for element timeout (in seconds).
User define (in seconds)Set a custom waiting time. Input a value in seconds.

Retry after executing all

Katalon allows you to rerun test cases in a failed test suite execution to identify flaky tests.

To do so, in the Retry after executing all text field, set the desired number of retry times. By default, this is set to 0.

Choose one of the following options:

  • Retry all executions: Retry all test cases when the test suite fails.
  • Retry failed executions only: Retry only failed test cases when the test suite fails.

    retry after executing all

For example, when a test suite execution fails, we want to rerun failed test cases in that test suite twice.

In the Retry after executing all checkbox, we input 2 in the text field, then we choose the Retry failed executions only option.

retry after executing all

In this case, the test suite is executed three times in total. The first one is the main execution; the latter two are the retried executions when the first execution fails.

retry after executing all

Katalon automatically generates reports after each test execution.

retry after executing all

Execute a dynamic test suite

After creating and configure a dynamic test suite, you can execute it as follows:
  1. Open the dynamic test suite.
  2. From the main toolbar, click Run.
    The Run dropdown list

    The test case is executed with the default browser defined in Project > Settings > Execution > Default execution.

    Alternatively, you can choose the environment in the dropdown list next to Run.

    The Run dropdown list

The Job Progress bar is triggered automatically to show the progress while your test case/test suite is being executed.

The Run dropdown list

You can also run the dynamic test suite in console mode. For detailed instructions on test execution in console mode, you can refer to this document: Command-Line Syntax in Katalon Runtime Engine.