Creating & Managing Test Suites
Test Suites allow you to group test cases for execution and reporting. A suite can contain explicitly selected test cases, dynamically selected test cases using filters, or a combination of both.
This guide explains how to create, manage, and maintain test suites effectively.
Creating Test Suites
To create a new test suite:
- Click Create Test Suite from the Test Suites page
- Fill in the test suite details:
Title
A concise and descriptive name for the test suite (required)
Description
A short summary describing the purpose or scope of the suite
Adding Test Cases to a Suite
You can add test cases using one or both of the following methods.
Manual Selection (Green)
Manual selection allows you to explicitly choose test cases.
Steps:
- Click Add / Update Manual Selection
- Browse or search for test cases
- Select the required test cases
- Confirm to add them to the suite
Behavior:
- Manually selected test cases are always included
- They remain in the suite regardless of filters
- Best suited for fixed or curated test collections
Filter-Based Selection (Violet)
Filter-based selection dynamically includes test cases based on rules.
Steps:
- Click Add by Filter
- Configure filter criteria such as:
- Priority
- Severity
- Test type
- Tags
- Custom fields
- Folder location
- Apply the filter to the suite
Behavior:
- Test cases are included automatically when they match the filter
- New test cases matching the filter are added automatically
- If a test case stops matching, it is removed from the suite
- Best suited for evolving or rule-driven test coverage
Note:
You can add multiple filters. Test cases matching any filter are included (OR logic across filters).
Understanding Test Suite Composition
A test suite may contain:
- Manual test cases (green)
- Filter-based test cases (violet)
- Both (hybrid)
Deduplication
- If a test case is included both manually and via filters, it appears only once
- Manual and filter-based selections are automatically deduplicated
- The total test case count always reflects unique test cases
Visual Indicators
The test suite badge indicates its composition:
- Green badge – Manual test suite
- Violet badge – Filter-based test suite
- Gradient badge – Hybrid test suite (manual + filters)
Editing Test Suites
To edit a test suite:
- Open the test suite details
- Click Edit
- Update any of the following:
- Title
- Description
- Manual test case selection
- Filter definitions
- Click Save to apply changes
Changes take effect immediately.
Deleting Test Suites
To delete a test suite:
- Open the test suite
- Click Delete
- Confirm deletion
What gets deleted:
- Test suite definition
- Manual selections
- Filter configurations
What remains unaffected:
- Test cases
- Existing test runs
- Historical execution data
Permissions
Test Suite actions are governed by project-level roles:
- View Test Suites – View suites and their composition
- Create Test Suites – Create new test suites
- Edit Test Suites – Modify existing suites
- Delete Test Suites – Remove test suites
Permissions are managed through project roles. Contact your project administrator if access is required.
Best Practices
- Use manual selection for fixed regression or release-critical suites
- Use filters for dynamic suites like smoke, priority-based, or coverage suites
- Prefer hybrid suites for maximum flexibility
- Keep suite titles descriptive and purpose-driven
- Review filters periodically to avoid unintended test inclusion
Next Steps
- Create a suite and use it in a test run
- Learn about Test Runs for executing suites
- Explore Releases to group executions by version
- Review Bulk Operations for efficient test selection