Create & Manage a Test Run - Execute Tests with Precision

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.

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.
• Description:Add optional context, such as scope, environment, release, or testing notes.
• Test Plans: Select one or more Test Plans to base the Test Run on.
• Milestone:Assign the Test Run to a Project Milestone, if needed.
• Due Date:Set a manual due date if the Test Run is not assigned to a milestone.
• Assignees: Choose the users responsible for executing the Test Run.

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

Note 2:If the Tes Run is assigned to a milestone with a due date, the Test Run inherits the milestone due date and the due date becomes read-only.

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.

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*.

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.

• 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

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.

• 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.

You can also update the Test Run description from the ‘Edit Run’ modal.

Use the description to add helpful execution context, such as:

• Scope of testing.
• Environment.
• Release version.
• Special notes.
• Links to related documentation.

Note: The description supports plain text and clickable links.

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!