How to navigate qTest Manager
Want to get yourself oriented with qTest? New to qTest Manager? This topic helps you familiarize yourself with everything you can do from the main menus in qTest Manager.
qTest Manager interface contains all your regular tools
Use the top menu
From switching between projects to locating administrative features, here's all the resources you'll find on the top menu bar.
Switch between projects
qTest Manager is organized by project, and your site can consist of multiple projects. You can configure each project as its own workspace, with its own data and reporting. Your team can be assigned to multiple projects and have different permissions for each project.
To switch between projects, use the Projects dropdown.
Switch between projects on any screen in Manager
You can also
Star your high priority projects to pin them to the top of the list.
Find resources
Select
Resources to go to the Support Hub, find version details about qTest, download qTest resources, and get documentation that's relevant to your current screen.
You can also select How to navigate the new UI to learn more about everything that's changed.
Search for objects
Need to do a quick search for all objects that mention API testing? Or maybe you remember creating that shopping cart test suite, but can't remember where you saved it.
To open the search window, select
Search in the top-right corner. You can enter keywords, or you can enter keywords in quotation marks to search for an exact phrase.
Use keywords to search for objects in the project you're working in
No matter where you are, when you use the search box, the system searches the entire project for your keywords.
To limit the search to specific objects, enter the following in your query before any keywords:
-
obj:req: Searches only requirements
-
obj:tc: Searches only test cases.
-
obj:tr: Searches only test runs.
-
obj:df: Searches only defects.
-
obj:ts: Searches only test suites.
For example, to search for the exact phrase shopping cart, but only in test cases, enter obj:tc "shopping cart".
qTest returns information from the following standard objects and fields:
-
Release: ID, Name, Status, Description, Release Note.
-
Build: ID, Name, Status, Build Note.
-
Requirement: ID, Name, Status, Description, Type.
-
Test Case: ID, Name, Description, Status, Type, Test Step Description.
-
Test Suite: ID, Name, Description, Execution Type.
-
Defect: ID, Summary, Description, Status, Type.
-
Test Run: ID, Name, Status.
If you create custom fields at the site level or at the project level, you can choose to make the following Field Types searchable: Text box, Text area, Combo box, Rich text editor, Number, Check box, URL, and Multiple selection combo box.
We offer several different search and filter features, so you can find exactly the object you're looking for. If you're working in the file tree, you can also filter objects or search with data query.
View notifications
Select
Notifications to view all your notifications.
The Notifications panel lists recent activity on objects you follow, along with who made each update and when
User menu
Select the
User menu to access any of the following tools:
-
My profile: Edit your name, email, or timezone, or change your password.
-
Company profile (administrators only): Edit company information, such as contact information and company name.
-
Schedule Notifications (administrators only): Access the Notification Center to schedule global notifications.
-
Administration (administrators only): Access global and site administration.
-
Return to classic qTest: Go back to the old user experience. You can switch back and forth as often as you want.
-
Sign out: Sign out of your qTest profile.
Use the left-hand menu
The left-hand menu contains your main test workflow. This is where you'll find most of your test records, as well as links to other apps.
You can expand or shrink the navigation menu with
Arrow button. Expand the menu to view tool names, or shrink the menu to get more workspace and navigate using icons.
The left-hand toolbar contains all of your test workflow, from planning, to running tests, to reviewing records
Here are all the resources you'll find in the left-hand menu:
Manage testing
Here, you can find the five main areas where you manage the objects you use in your testing:
-
Test plan: Create and manage releases and builds.
-
Requirements: Create and manage testing requirements.
-
Test design: Create and manage test cases.
-
Test executions: Create and run tests.
-
Defects: Create and manage defects native to qTest.
Learn more about the details of your test management organization.
Manage your recycle bin
qTest keeps all deleted objects in the recycle bin of the project you're working in. To open the recycle bin, select
Recycle bin in the left-hand toolbar.
Deleted objects stay in the recycle bin until you choose to restore or delete them permanently. To do either, select the checkboxes next to deleted objects and choose one of the following actions:
-
Restore: Users with the permission to delete an object can also return objects in the recycle bin to their original location. For example, if you have the Delete Test Runs user permission, you can restore any deleted test runs from the recycle bin.
-
Delete permanently: Users with the Manage Recycle Bin Settings user permission can delete objects permanently. Be careful! You can't undo this action.
Go to other qTest applications
You can find all of your qTest applications on the left-hand toolbar. Select qTest apps to navigate to Explorer + Sessions, Parameters, Insights, Pulse, or Launch.
If you're outside of a project, select the qTest logo to return to the project before you switch to an external app. For example, you can no longer switch to an external application if you're in Administration or the Notification Center.
Background actions
Select Background actions to view any processes currently running in the background, such as bulk changes.
The Background processes panel shows the status and progress of long-running operations
Manage project settings
To manage your project settings as an administrator, select the Project settings dropdown from the left-hand toolbar.
Use your file tree
The file tree contains information that you can use to organize objects and quickly navigate between them.
The file tree displays useful information for your objects in qTest
You can use these options with any object in the file tree:
-
Check the number of sub-objects: Check the number to the right of an object to see how many child objects it has. For example, test cases in a module or test runs in a release.
-
Move objects: Select
Reorder next to an object, and then drag it to another location in the file tree to move it. -
Take action: Select
Actions next to an object to view the list of actions you can take with that object. The available actions depend on the object you select. For example, you can copy an object, add new test cases to a module, or delete an object from this menu.
The following icons indicate the status of objects in your file tree:
Release and build objects have icons that display the object's selected Status.
The following icons indicate the object status:
-
Planned -
In Progress -
Closed -
Completed
Test case icons let you know whether a test case is a manual test case or an automated test case, and whether it's approved for test execution.
The following icons indicate the test case status and type:
-
Manual test or
Automation test -
Approved or
Unapproved
Adjust tree view
In each tab, you can choose whether or not to view the unique object IDs next to each object in the tree. This can help you differentiate between objects with similar names.
On the Test Execution tab, you can also choose to show or hide test runs in the tree. This can simplify your navigation, if you want to navigate using only test cycles, test suites, and releases.
To view these settings, select
Tree view settings in the tree panel toolbar. Then, adjust your view accordingly. To sort your tree menu, you can chose between three different options: Sort manually, Sort by ASC, Sort by DESC. Note that the sort applies only to you and resets when you sign out. You can't drag and drop while sorting, and if you paste artifacts, qTest SaaS adds them at the end of the list.
To collapse the tree menu to free up workspace, select
at the bottom of the menu.
Filter objects
You can apply filters to narrow down objects in the tree panels on the Test Plan, Requirements, Test Design, and Test Execution tabs.
Just select
Filter on the tree panel toolbar, and go to Set Filter. This opens the Filter window, where you can set your desired filter criteria. Please note that the available criteria change depending on the objects you're trying to filter. When you're done, select Filter to apply the criteria.
To remove a filter, select
Filter, then select Clear Filter.
Search with data queries
In addition to basic search features, we also offer Data Query to create and save detailed custom queries, edit and approve objects in batches, and create detailed reports. Simply select
Data Query in the tree panel toolbar.
The Data Query feature is available in the following tabs:
-
Requirements: Run queries for requirements, such as queries displaying unassigned requirements or requirements that are not associated with test cases.
-
Test Design: Run queries for test cases, such as queries displaying all approved test cases or test cases that do not have test steps.
-
Test Execution: Run queries for test runs, such as queries displaying unassigned test runs or test runs that are not associated with requirements.
-
Defects: Run queries for defects, such as queries displaying defects assigned to you or defects assigned to another user.
For detailed information, check out Data Query.
Export data
While you can get more detailed reports from Insights, there are a few basic Excel files that you can export. You can export data from the file tree in Requirements and Test design. Or, you can export data from the file tree, test run grid, or Data Query in Test execution.
To export your data as an .xls file, follow these steps:
-
Select the objects you want to export in the tree panel. To select multiple objects, hold Ctrl while you select the objects.
-
Select
Export in the tree panel toolbar. Then, select the report that you want to export from the dropdown menu. -
In the export window, choose the fields you want to include in the report. You can use the up and down arrows to reorder the fields you've selected.
Add fields you want to export to the box on the right
-
Select OK to download your report as a .zip file.
Collaborate in qTest
We know you don't work alone, so we made sure qTest has features that let you follow and communicate with other members of your team.
View object history
If you want to see who made a change, when a change was made, or what changed, check the object's History tab.
The following types of objects have history tracking: requirements, test cases, test suites, test runs, and defects.
Changes between different versions of a test case in the History tab
Leave comments on objects
To leave a quick note for other users, create a comment. qTest includes your name and a time stamp with your comment.
-
If you're in a requirement, test case, or test run, go to the Comments tab to leave a comment.
-
If you're using qTest's internal defect tracker, use the Comment field on the defect. Note that you need to save a new defect before you can view its comment field.
The Comment tab on an object displays all user comments with a timestamp and the commenter's name
Get notified about objects
Want to know when an object is assigned, updated, commented on, or otherwise interacted with? Select the Manage subscription button on an object to sign yourself, or someone else, up for email and in-application notifications for any updates related to that object.
Use the Manage Subscription window to add users to a notification list for the object
A few notification events are active for object Assignees and Subscribers by default, but you can go to Notification Settings in Manager to customize what actions on an object send a notification and who gets notified.
Use keyboard shortcuts
Keyboard shortcuts help you create, save, and delete objects.
Available shortcuts depend on the qTest Manager tab you're using:
|
Shortcut |
Tab |
Action |
|---|---|---|
|
Ctrl+S |
Test Plan, Requirements, Test Design, Test Execution, and Defects |
Save an object. |
|
Ctrl+G |
Test Plan, Requirements, Test Design, and Test Execution |
Save an object and open the next object at the same level in the tree. |
|
Shift+D |
Test Plan, Requirements, Test Design, and Test Execution |
Create a release in Test Plan, a module in Requirements or Test Design, or a test cycle in Test Execution. |
|
Shift+Delete or Shift+X |
Test Plan, Requirements, Test Design, and Test Execution |
Delete the selected objects. |
|
Shift+C |
Test Plan, Requirements, and Test Design |
Create a build in Test Plan, a requirement in Requirements, or a test case in Test Design. |
|
Shift+S |
Test Execution |
Create a test suite. |
|
Shift+R |
Test Execution |
Create a test run. |
|
Ctrl+E |
Defects |
Save and close a defect. |
UI improvements
We heard your feedback and updated our new design accordingly. Here's exactly what's changed:
|
Component |
Description |
|---|---|
|
Content fields |
To improve readability, long object names in the content area no longer shorten for space. When there isn't room on the screen for a full title, action buttons move to a new row. |
|
File tree |
Added a scroll bar to the bottom of the file tree, so you can read long object names. |
|
File tree |
Users can now copy and paste test cases between projects. |
|
File tree |
Users can now copy test suites and paste them under releases or test cycles. |
|
File tree |
Adjusted spacing and font size in the file tree so more of the hierarchy is visible, especially on smaller screens. |
|
Right-click menu |
Fixed an issue where the browser right-click menu didn't work in text fields. |
|
Search |
When a user searches for an object in a file tree, the search now highlights the correct item the user searched for. |
|
Text editor |
Fixed an issue where working in Test Step fields automatically opened the formatting toolbar, which blocked tab navigation between fields. The toolbar now opens when you select the |
|
Text editor |
Improved image resizing in the text editor. |
|
Text editor |
Fixed a font mismatch in the text editor. Text now matches the size and style used across the rest of qTest. |
What's next
If you want to learn more about the basics of qTest, check out Get started with qTest Manager.