Create or manage test cases

Learn how to create an empty test case or how you can add more.

requirements

• Make sure you are a Project Admin or possess the relevant permissions or roles (such as Tester or Test Lead). Go to roles or permissions for more information or learn how to assign a Project Admin here.

Create Test Case

1. Navigate to your specific project's UI > Tests > Test Cases.

2. Click on the + Create button. Select Test Case.

3. Fill out the following information:

   • Name (required): Input the label for your test case.
   • Automation Status (required): Select the current stage of the test case in the automation lifecycle.
   • Priority (required): Set the priority level (e.g., High, Medium, Low).
   • Location (required): Select where you want to save your test case.
   • Description (optional): Input details about your test case.
   • Precondition (optional): List the prerequisites for your test case.
   

4. Click Create.

• Alternatively, click on "Save & Create Another" to immediately input information for an additional test case without navigating away from the current screen.

Result

You have successfully created a new test case in Katalon TestOps.

---

Additionally, you can create more test cases directly from the Test Case List Page.

1. Type out its name in the Add Test Case field.

2. Click Add.

Import Test Cases

You can import test cases from a CSV file into Katalon TestOps. During import, all CSV values are automatically mapped to their corresponding TestOps fields, including any requirements linkages from your configured ALM integrations (e.g., Jira or Azure DevOps).

1. Navigate to your specific project's UI > Tests > Test Cases.
2. Click the + Create button, then choose Import Test Cases.

3. Upload your CSV file from your device and click Next.
4. TestOps will automatically map each field in your CSV file to a corresponding TestOps field. You can adjust these mappings if needed.
5. Review the mapped fields in the preview. When you're ready, click Import.

Result

Your CSV test cases, including all associated fields and values, are now successfully imported into TestOps.

Import Linkages

requirements

Make sure you’ve already configured an ALM integration like Jira or ADO.

In TestOps, Linkages let you associate test cases with requirements from your ALM tools (like Jira or Azure DevOps). This ensures clear traceability between requirements and what’s being tested, visible directly within each test case.

When importing test cases from a CSV file, you can include a column that links each test case to a requirement in your ALM tool.

• You don’t need to name the column exactly "Requirements Linkages". You can name it anything, you’ll map it to the correct field during the import process.
• If a cell is left blank, that test case won’t be linked to any requirement.

For example, if your ALM has an issue called SCRUM-5, and your CSV includes a column that lists SCRUM-5 for a test case:

Result

TestOps will automatically link the imported test case to the corresponding issue.

Edit Linkages

After importing or creating test cases, you can update their requirement linkages at any time to reflect changes or correct mappings.

1. Open the test case you want to update.
2. In the test case detail view, go to the Linkages panel.
3. Click Click to link requirement(s) to add one or more issues. Search for and select the requirement(s) from your connected ALM tool.
   • To remove a linkage, click the Unlink icon next to the issue. The change will be applied automatically.
4. Click Link to apply your changes.

Manage Test Cases

To manage an individual test case:

1. Click on its name to open the Test Case Detail page.

2. Use the action buttons in the upper right:

   • Move – Move the test case to a different location.
   • Duplicate – Create a copy in the same location.
   • Delete – Remove the test case from your repository (its result history is retained).
   

Additionally, to save time, you can also perform bulk actions:

1. Select multiple test cases using the checkboxes on the left.

2. Use the top action bar to:

   • Move – Select a new location from the dialog and confirm.
   • Duplicate – Make copies of selected test cases.
   • Delete – Remove them after confirming the action.