Create a Test Run

Creating a Test Run helps organize and execute a specific set of test cases to meet your testing objectives. Follow this guide to set up a Test Run efficiently.

Learn what is a Test Run here.

1. Create from the Test Plan’s Page

  • Navigate to the Test Plan’s page and select the Test Plan you want to use.
  • Click the ‘Create Test Run’ button.
  • The Test Run will automatically include the test cases from the selected Test Plan, arranged in the same order defined in the plan’s Checklist.
Create a Test Run based on a Test Plan

2. Create from the Test Runs Page

  • Go to the Test Runs page.
  • Click the ‘+ Test Run’ button to open the creation form.
  • Fill out the following details:
    • Title: Enter a unique name for the Test Run.
    • Test Plans: Select one or more Test Plans to base the Test Run on.
    • Assignees: Choose the users responsible for executing the Test Run.

Note: Skip the ‘Test Plans’ field if you prefer to manually add test cases.

Create a Test Run

3. Manually Include Test Cases

If you skipped the Test Plans field during creation:

  • Open the Test Run’s inner page.
  • Click ‘Edit Run’ to access the test case selection interface.
  • Use the checkboxes to select the test cases you want to include in the Test Run.
Manually add / remove Test Cases from a Test Run

4. Start Running

Once the Test Run is prepared and all desired test cases are included, start the execution process.

Learn more about running Test Runs here.

Execute a Test Run

Manage a Test Run

Managing a Test Run ensures your testing process stays organized and adaptable to your needs. Follow this guide to work efficiently with Test Runs.

1. Test Run View Modes

Test cases in a Test Run can be displayed in two modes:

  • Grouped-by-Suite View Mode:
    • Default view, grouping test cases by Suites.
    • Sorting is inherited from the Test Cases page and can only be updated by Project Administrators.
Grouped-by-Suite View Mode of Test Run
  • Checklist View Mode:
    • Displays a flat list of test cases.
    • Test cases can be rearranged using drag&drop by any Project Member.
    • Ideal for customizing the order for convenient testing workflows
Checklist View Mode of Test Run

2. Rearranging Test Cases

  • Checklist View Mode:
    • Use drag-and-drop to reorder test cases for your preferred testing sequence.

Note: Changes in Checklist View Mode do not affect the order in the Grouped-by-Suite View Mode.

Drag&Drop Test Cases in a Checklist View Mode
  • Test Runs Created from Test Plans:
    • If the Test Run is based on a Test Plan, the test case order from the Test Plan is applied.

Note: Any changes made in the Test Run will not affect the Test Plan’s original order.

3. Edit a Test Run

Use the ‘Edit Run’ modal to update Test Run details:

  • Title: Modify the Test Run name.
  • Assignees: Add or change the testers assigned to the Test Run.
  • Include/Exclude Test Cases: Adjust the list of test cases in the Test Run.

Note: Newly added test cases in Checklist View Mode will appear at the bottom of the list.

Edit Run Form
Edit Test Run title in-line

What’s Next?

Managing Test Runs effectively ensures smooth execution and adaptability for testing needs. For additional help, check related guides or contact support—we’re here to help!