Creating & Managing Test Suites - Step Guide

Creating Test Suites

To create a new test suite:

  1. Click the Create Test Suite button in the header
  2. Fill in the test suite details:

Title: A concise name for the test suite (required)

Description: A brief summary of what the test suite covers

Test Cases: Add test cases to the suite using one or both methods:

Manual Selection

  1. Click Add Test Cases to open the test case selector
  2. Browse or search for test cases
  3. Select test cases to add
  4. Click Add to include them in the suite

Manually selected test cases are always included in the suite, regardless of filters.

Filter-Based Selection

  1. Click Add Filter to create a filter
  2. Configure the filter criteria:
    • Status: Filter by test case status
    • Priority: Filter by test case priority
    • Type: Filter by test case type
    • Custom Fields: Filter by any custom field values
    • Tags: Filter by test case tags
    • Folders: Filter by folder location
  3. Click Apply Filter to add it to the suite

Filter-based test cases are dynamically included based on the filter criteria. If new test cases match the filters, they are automatically added to the suite.

Note: You can add multiple filters. Test cases matching any filter will be included (OR logic).

  1. Click Create to create the test suite

Understanding Test Suite Composition

When a test suite includes both manual test cases and filters:

  • Manual test cases: Always included, regardless of filters
  • Filter-based test cases: Included if they match any filter criteria
  • Total count: Shows the combined count of all included test cases

The test suite badge indicates the source type:

  • Teal badge: Manual test suite
  • Violet badge: Filter-based test suite
  • Gradient badge: Hybrid test suite (both manual and filters)

Editing Test Suites

To edit a test suite:

  1. Open the test suite details (click on the test suite row)
  2. Click the Edit button
  3. Modify the fields as needed:
    • Title
    • Description
    • Manual test cases (add or remove)
    • Filters (add, edit, or remove)
  4. Click Save to update the test suite

Managing Manual Test Cases

To add manual test cases:

  1. Click Add Test Cases in the Manual Test Cases section
  2. Select test cases from the selector
  3. Click Add to include them

To remove manual test cases:

  1. Click the remove icon (×) next to a test case
  2. The test case is removed from the suite

Managing Filters

To add a filter:

  1. Click Add Filter
  2. Configure filter criteria
  3. Click Apply Filter to add it

To edit a filter:

  1. Click on an existing filter
  2. Modify the filter criteria
  3. Click Apply Filter to save changes

To remove a filter:

  1. Click the remove icon (×) next to a filter
  2. The filter is removed, and matching test cases are excluded

Note: Removing a filter only removes the filter criteria. Manually selected test cases remain in the suite.

Deleting Test Suites

To delete a test suite:

  1. Open the test suite details
  2. Click the Delete button
  3. Confirm the deletion in the confirmation modal

Note: Deleting a test suite removes:

  • The test suite definition
  • Manual test case selections
  • Filter configurations

Note: Existing test runs and test execution history are not affected.

Permissions

Test Suites are subject to project-level permissions:

  • View Test Suites: View test suites list and details
  • Create Test Suites: Create new test suites
  • Edit Test Suites: Modify existing test suites
  • Delete Test Suites: Remove test suites

Permissions are managed at the project level through roles. Contact your project administrator if you need additional permissions.

Was this page helpful?