Skip to main content

Test Suites

Test suites are organizational containers for test cases inside a test project. They work like folders in a file system — you can nest them to any depth and move cases between them freely. Suites have no effect on test execution. They are purely for organization. When you create a test run, you can choose to include all cases from a specific suite, which makes suites a convenient way to scope a run to a particular area.

When to use suites

Suites become valuable when a project grows beyond 20–30 test cases. Without them, the flat case list becomes difficult to navigate. Common grouping strategies: Choose the grouping strategy that matches how your team thinks about the product.

Creating a suite

1

Open the test project

Navigate to the Space → Test Management → select the project.
2

Open the Suites panel

The left panel of the project shows the suite tree. If the project is new, the panel shows only the project root.
3

Click + New Suite

Click + New Suite at the top of the suites panel.
4

Enter a name

Type the suite name. For example: “Checkout Flow” or “Authentication”.
5

Create

Press Enter or click Create. The suite appears in the left panel.

Creating a sub-suite

Suites can be nested inside other suites to any depth. For example, you might have a suite called “Checkout Flow” with sub-suites “Guest Checkout”, “Registered User Checkout”, and “Payment Methods”.
1

Hover over the parent suite

In the left suites panel, hover over the suite you want to nest inside.
2

Click the + icon

A + icon appears to the right of the suite name. Click it.
3

Enter the sub-suite name

Type the name and press Enter. The sub-suite appears indented under the parent suite.

Adding test cases to a suite

When creating a new test case, select the suite from the Suite dropdown in the creation form. The case is placed in that suite immediately. To move an existing case into a suite:
  1. Open the case detail view.
  2. Click the Suite field in the case sidebar.
  3. Select the target suite from the dropdown.
  4. The case moves to the new suite immediately.
The left panel shows the full suite tree. Click any suite to filter the case list on the right to show only cases in that suite. Click the project root (the project name at the top of the tree) to see all cases regardless of suite. Suites that contain sub-suites show a collapse/expand arrow. Click it to toggle the sub-suites.

Reordering suites

Drag any suite in the tree to reorder it. Drop it above or below another suite at the same level to change its position, or drag it onto a different suite to make it a sub-suite of that suite.

Suite statistics

Each suite in the left panel shows a count of cases it contains. The count includes cases in sub-suites. Cases are broken down by status:

Deleting a suite

1

Right-click the suite

Right-click the suite name in the left panel, or hover and click the ... menu that appears.
2

Select Delete

Click Delete suite.
3

Confirm

Confirm the deletion in the dialog.
Deleting a suite does not delete the test cases inside it. Cases from a deleted suite are moved to the project root (no suite). They remain in the project and can be reassigned to another suite at any time.
Last modified on June 21, 2026