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're working to improve search results, and you may currently experience issues with custom fields in search results. If this is happening for you, please reach out to support.

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:

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:

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:

  1. Select the objects you want to export in the tree panel. To select multiple objects, hold Ctrl while you select the objects.

  2. Select Export in the tree panel toolbar. Then, select the report that you want to export from the dropdown menu.

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

  4. 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 icon.

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.