Manage test suite collections in Katalon Studio

Last updated: May 2026

A test suite collection (TSC) contains a list of test suites, which allows you to execute multiple test suites together in either parallel mode or sequential mode.

Create a new test suite collection

To create a new test suite collection, do as follows:

1. In the Tests Explorer panel, right-click on the Test Suites folder > New > Test Suite Collection.
   
   Alternatively, you can also go to File > New > Test Suite Collection from the main menu.
   A New Test Suite Collection dialog appears.
2. Fill in the name and the description (optional).
3. Click OK.

You have successfully created a new test suite collection.

Add test suites to a test suite collection

To add test suites to a test suite collection, do as follows:

1. In the command toolbar, click Add.
   A Test Suite Browser dialog appears, displaying all of the Katalon Studio test suites.
2. Select the test suites you wish to execute. Click OK.
   The selected test suites are added to the test suite collection accordingly.

   

3. After adding test suites to the test suite collection, you need to configure the environment for test suite execution. The following table will provide you with the detailed description to set up the environment.

   Field	Description
   Run with	To select the environment executed with the Test Suite.
   Run configuration	This column allows you to specify the configuration for the selected environment. This is mostly applicable to mobile environment. For example: When you choose iOS environment, you can select which iOS devices you want to execute with by clicking this column.
   Profile	Execution Profile that contains all variables values for each Test Suite execution. To learn more about the execution profile, you can refer to this document: Execution Profile.
   Run	To choose the test suite you wish to run in the test suite collection. This is checked by default.