Organizing Tests into Suites

Organizing Tests into Suites

A test suite groups related test cases together for bulk execution, reporting, and maintenance. This guide walks through creating a suite, adding test cases to it, and organizing suites into folders.

Workflow 1: Create a Test Suite

Steps

1. Navigate to Test Suites in the left sidebar.
2. Click + New Suite (top right).
3. Fill in the suite details:
   • Name: A unique, descriptive name (e.g., "Authentication Tests")
   • Description: What this suite covers
   • Folder/Path: Optional hierarchical location (e.g., Features/Auth) — leave blank to place at the project root
   • Default Priority: Priority applied to new tests added to this suite
   • Auto-apply Tags: Optional tags automatically applied to tests in the suite
4. Click Save, or Save & Add Cases to immediately open the test case selector.

Workflow 2: Add Test Cases to a Suite

Steps

1. Open the suite's detail view.
2. Click + Add Test Cases to add existing cases, or + Create New Case to write one directly into this suite.
3. If adding existing cases: search or filter by title, ID, or tag, check the cases you want, then click Add.

Adding a case to a suite doesn't remove it from any other suite it already belongs to — a single test case can belong to multiple suites at once.

Workflow 3: Reorder Test Cases within a Suite

Steps

• Drag and drop: hover over a row, click and hold the six-dot drag handle, drag to the new position, and release.
• Bulk reorder: check multiple test cases, then drag any one of the selected rows — all selected cases move together.
• Auto-sort: use the "Sort A-Z" or "Sort by Priority" options to reorder the whole suite automatically.

Reordering saves automatically — there's no separate save step.

Workflow 4: Organize Suites into Folders

Suites can be nested into folders for project-level structure (distinct from suite-level grouping of test cases).

Steps

1. From the Test Suites list, click the + New Folder option in the top-right dropdown.
2. Move existing suites into a folder by dragging them onto it, or by setting the Folder/Path field when creating or editing a suite.
3. Toggle between list view and folder tree view to navigate large suite hierarchies.

A common pattern is to use folders for project-level structure (e.g., Features/, API/) and suites underneath for test-type grouping (e.g., "Login Smoke Tests," "Login Regression Tests").

Workflow 5: Run a Suite

Steps

1. Open the suite's detail view.
2. Click Run Suite (top right).
3. Choose the target environment, optionally assign someone for manual execution, and optionally link a milestone.

Running a suite creates a new launch containing all of its test cases, executed in the suite's current order.

Related

• Test Suites Reference — full field, action, and keyboard-shortcut reference this guide is based on
• Test Suites Concept — why suites exist and how they differ from test plans
• Creating Test Cases — write the test cases you'll add to a suite
• Executing Tests — run suites as part of a broader test plan