Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

QMetry allows testers to organize and manage test cases in a Folder structure-based hierarchy. Testers can group related test cases and organize them systematically during authoring/post authoring. As an example, testers can create folders like Regression Test, Smoke Test, Sanity Test, etc. to group related test cases. Each new test case folder creates the next level of test case organization in your test case tree. It helps in carrying out bulk operations like associating test cases to a story, copy/move test cases from the source folder to the destination folder.

Table of Contents

Where to find the feature?

Open the QMetry app.

It opens the menu like below. Select Test Management on it.

There are four sections in Test Management:

  • Test Case

  • Test Cycle

  • Test Plan

  • Test Report

Click on the Test Case tab to organize test cases in folders.

The left pane displays the folder structure of test cases. The right pane displays all test cases until you select a particular folder to view particular test cases.

1. Project selection.

By default, the project that you selected in Jira will be displayed here. You can select another project. The folder tree is rendered in accordance with the project selection.

2. Root test case folder, which shows all the test cases created within the project irrespective of the folder within which it is created.

3. Sub folders within the root folder.

Create Test Folders/Sub Folders

Add Folder

Follow either of the following ways to add a new folder under the root/sub folder.

A. Right-click on the folder under which you want to create a new folder and select Add Folder.

Image RemovedImage Added

B. Select the folder under which you want to create a new folder and click on the + Folder button above the tree.

The Add new folder screen opens.

  • Enter Folder Name and Description, select/change the Parent Folder Path, and click Submit. It creates a sub-folder under the selected folder.

  • Create another: Select the checkbox to keep the Add New Folder pop-up open to continue adding folders.

A new folder is added to the tree on the sub-level hierarchy.

Folder Hierarchy View

Users can view the details about the number of test cases within the current folder and the total test cases, including test cases of sub-folders.

The syntax of folder hierarchy represents -

<folder name> No. of test cases within current folder (Total no. of test cases, including test cases of sub-folders)

Edit Folder

Right-click on the folder name and select Edit Folder.

Image RemovedImage Added

You can rename the folder and change the description.

You can expand the size of the folder structure panel. Keep the panel size as per your requirement by clicking on the arrow button or by dragging it with the mouse.

Choose to show/hide Child Test Cases from Sub Folders

Users can opt to show/hide test cases from sub folders at parent folder. By default, the Display Test Cases of Sub Folder(s) option remains disabled for new projects and new users. The test cases from sub-folders remain hidden at parent folder level on the test case list view. To display the child test cases, open the More options menu on the test case tree at left, and select Display Test Cases of Sub Folder(s).

Use Case: Users want to view test cases of the sub-folders at the parent folder level instead of navigating to the sub-folders.

  • The set preference is applied to all the screens from where the test case module list opens up.

  • If the same test case is part of multiple sub-folders, then it is displayed only once at parent folder.

  • Export and other Bulk Operations from parent folder level are carried out as per the set preference for child test cases.

Rearrange/Sort Folders

Test Case folders can be arranged on Name and Date. Open the Sort by drop-down and select the option to arrange the folders on the tree. The folders can be sorted alphabetically and by date of creation in an ascending/descending manner. By default, folders are sorted on Oldest First.

Copy/Cut and Paste Folder

Copy & Paste: You can Copy a folder and Paste it to another folder. This will create a copy of the existing folder with test cases under it.

Cut & Paste: You can also Cut a folder and Paste it to another location/folder on the tree to change the hierarchy. All the test cases under the folder will also move along with the folder.

Image RemovedImage Added

Right-click the folder in which you want to paste the cut/copied test case folder.

Image RemovedImage Added

Delete Folders

Right-click on the folder that you want to delete and select Delete Folder. It will permanently delete the selected folder. If there are sub-folder under the folder, then all these sub-folders will be deleted. All the test cases under such folders will be disassociated with the folders and moved to the root folder. You will still have an option to move these test cases to the folder of your choice.

Image RemovedImage Added

On clicking Delete, the user is asked to select a folder in which they want to move the underlying test cases so that they can keep the test cases in the preferred folder.
If a folder is not selected, then the test cases will be moved to the root folder. i.e. "All Test Cases" folder here.

Copy Folder Path 

Right-click on the folder for which you want to copy the folder path and select the Copy Folder Path option. The folder path will be copied to the clipboard.

Image RemovedImage Added

Copy Folder ID

Users can directly add test cases created via Automation into the defined test case folder using the Folder Id.

Use Case: An automation engineer wants to arrange test cases created via Automation API, Maven Plugin, Jenkins/Bamboo into a specific folder that can be provided as a parameter, instead of default root folders.

Right click on the folder the Folder ID of which you want to copy and select the Copy Folder Id option on the menu. The folder Id will be copied to the clipboard. You can use it in Automation API and Maven, Jenkins & Bamboo plugins for adding created test cases in a particular folder.

Image Modified

Copy Folder Link

Users can share a specific Test Case folder by sharing the folder link with other users. The link is accessible to other users within the project. Users with whom the link is shared can open the folder link and directly go to the folder. Users can access the folder and its data. If it is a parent folder/root folder, the data is displayed accordingly.

For example,

In a project, Project Managers, Developers, and other teams are working in collaboration with each other. They also create test assets like test cases required for the project. They prefer to have a direct folder link and share it across teams for the ease of adding test cases to it.


  1. Right-click on the folder and select the Copy Folder Link option. The link is copied to the clipboard.

  2. Share this link with other users through the channel accessible to them. For example, you can paste the copied folder link in the email. The recipient of the email can then directly go to the folder and start working on it.

Image RemovedImage Added

Export Test Cases to Excel

Test Case folders can be exported using the Export Excel option. This enables users to share test cases as per the folder structure in QMetry projects and to save for further references.

If the Display Test Cases of Sub Folder(s) option is enabled on the tree, then the test case of sub-folders will also be exported along with the test cases of parent folder.

Right-click on the folder the test cases under which you want to export and select “Export to Excel”.

Image RemovedImage Added

Click on the notification icon as shown below:

Once the process is complete, click on the Download File as shown below. Users will be able to get data for all Test Cases in an excel format.

Search Folders

Users can search for folders on the folder structure through the search box. It is useful where the folder structure is very complex with multiple hierarchies or the folder list is too long to locate a specific folder.

All Test Cases (Root Folder)

You can perform the following operations on the root folder:

  • Add Subfolder

  • Paste the copied/cut folder

  • Copy Folder Link

  • Export to Excel

  • Link with Test Cycle: Link all the test cases under the folder with the test cycle.

  • Link with Story: Link all the test cases under the folder with the story.

You can not perform other operations on the root folder that are available on sub-folders like edit, delete, cut, copy, etc.

From the root folder, you can perform only Reuse action (and not Move action) for test cases as the test cases remain on the root folder and are not moved.

Bulk Operations

The options for carrying out Bulk Operation remain invisible by default. The options available for Bulk Operations become visible on the screen as soon as you select at least one record.

You can also perform the following Bulk Operations on test cases. Follow the links for more details.

Move/Reuse Test Cases

Bulk Update

Bulk Delete

Link with Test Cycle (Plan Test Case for Execution)

Link with Story (Plan Test Cases in Story)

Export Test Cases

Import Test Case

The Import Test Case feature helps you import test cases from Excel file (CSV/XLSX format) file into QMetry for the Jira add-on. Read more details on this page Import Test Cases.