Create and delete test cases

As part of your testing journey, you'll create and store test cases in the Test Design tab. A test case should cover a specific scenario that needs testing, the steps needed to perform a test run, and the expected results of the test run.

You can create a test case in one of the following ways:

Manually create a test case from scratch in the Test Design tab.
Generate a test case from an existing requirement in the Requirements tab with our AI test case creation tool.

For more tips on how to use qTest to structure your testing process, check out Build Your qTest Manager Repository: Test Design and Test Execution.

How to create test cases video

For highest quality, watch this video in full-screen mode.

Manually create a test case

To start testing your software, first you need to create a test case that defines what, where, and how to test.

Note that you can edit existing test cases at any point.

To create a test case, follow these steps:

In qTest Manager, go to the Test Design tab.
Optionally, select the module you want to add the test case to from the left panel.

Note that you don't have to perform this step, but we recommend that you create at least one project module when you organize your test cases. If you organize your test cases into a nested folder structure with modules, they'll be much easier to find later.
Select in the toolbar to create a new test case.
Enter a unique title for the new test case.
Enter any additional information for the test case, such as a Description and who the case is Assigned To.

Note that the Status, Type, Version, and Priority fields are automatically populated by qTest Manager, but you can edit the information in these fields as needed.

To create custom fields or modify existing system fields, see Field Settings.

You can automatically send email notifications to other users when test cases (or other objects) are assigned to them. For information on how to configure email notifications, see Notification Settings.
Click Save.

Once you've created a test case, drag and drop it into the left navigation panel to organize it.

Enter test steps for a test case

Each test case should contain test steps that define which actions the testers need to perform during a test run. A test step defines a planned action performed by the user, alongside an expected result from the software you're testing.

To create your test steps, go to the Test Steps section at the bottom of the test case and follow these instructions:

Optionally, add any preconditions you may have for this test case, select the field in the Step Description column to add a description for step 0.
For step 1, enter the Step Description and Expected Result.

You can also create parameters to call in your test steps. Use parameters to capture recurring information between tests, such as usernames and passwords that you use when testing. For more information on calling parameters, see Call a Parameter in a Test Case.
Optionally, select to add an attachment to the test step.

In the following Attachments dialog, select a file to upload, take a screenshot, or drag and drop a file to add an attachment.
Optionally, add your desired information to any custom fields you've set up to record specific testing information in your steps.

For information on how to add custom fields, see Site fields.
Select Add to create the next test step.
Repeat steps 2-5 to add as many test steps as you need.
After you're finished adding test steps, select Save.

Generate a test case with AI

Once you've created a requirement, your next step is to create a set of tests that ensure your software meets that requirement. Between brainstorming, writing, and reviewing, this is a pretty time-consuming process.

To save time, you can use AI to turn your existing requirements into a detailed test case with the click of a button.

Before you can use our AI test case feature, you need to turn AI integration on at the site level and then turn AI Generated Test Cases on in the project where you want to generate test cases.

To create a test case with AI, follow these steps:

From Requirements, open the requirement you want to create a test case from.
Go to the Create Associated Test Cases section and select Generate with AI.
In the Generate Test Cases window, AI generates the name, description, and steps for 10 test cases.
At this point, you can manually edit the content. Revise or delete any AI-generated Step on each test case as you fit, or select Add Step to add a new step.
Or, you can use AI to refine the content. Select Customize to refine the test case you're looking at, or select the three-dot menu next to the individual test step you want to customize. From here, you can:
- Re-generate: re-create the content you selected with different wording. If you re-generate the full test case, the description of test case description doesn't change.
- Elaborate: add more detail to the content you selected.
- Summarize: shorten the content you selected.
When you're finished, select the checkboxes next to each test case you want to save, or select the checkbox at the top to select all test cases. Then, select Add Test Cases to add the test cases to the Linked Test Cases for your selected requirement.

Note that you can edit your saved AI-generated test cases at any point from Test Design. You can't modify or delete test cases that are linked to objects in Tosca.

Add an attachment to a test case

To add more context to your test case, you can attach files. For example, you can add a screenshot of the location where you're testing.

To add an attachment to your test case, follow these steps:

In Test Design, open the test case you want to add an attachment to.
Go to the Attachments tab.
On the right side of the Attachments tab, you can add attachments with any of the following options:
- Select Upload Files to browse for and select a file to upload from your computer.
- Take a screenshot with a third-party program and use Ctrl+V to paste the file from your clipboard.
- Drag and drop a file to the Drag and drop file here (Maximum Size 50MB) section to add the file as an attachment.
After you upload the file, select Save.

Delete a test case

Maybe you've created duplicates, or maybe you've decided that a particular scenario doesn't need testing. Don't worry, you can delete test cases at any point.

Deleting a test case removes any test steps that contained the deleted test case as a called test case, as well as any test runs created from the deleted test case.

Attached requirements don't change, but any record of their link to the deleted test case is removed.

To delete a test case, follow these steps:

In Test Design, select the test case you want to delete from the tree panel.
Right-click the test case, and then select Delete from the menu.

The test case is deleted.

Note that you can restore deleted test cases from the Recycle Bin.

You can't modify or delete test cases that are linked to objects in Tosca.

What's next

Still editing your test case? You may want to learn how to attach requirements, or how to save time when you reuse test cases you've already created.

Ready to start testing? Once you've prepared your test case, it's time to create test runs in the Test Execution tab, where you can start your testing and log execution results.