User Groups


User Groups is available for Manager 9.3+ and provides qTest Site Administrators the ability to apply bulk changes to User permissions, across projects. qTest offers pre-defined User Groups by default, but also allows Site Administrators to create custom User Groups, either from scratch or by editing an existing a pre-defined group.

User Groups Video

Hint: Watch the video in full-screen for the highest quality.

Why Use User Groups?

User Groups makes Administrators' lives easier by allowing them to easily assign batches of permissions to batches of users. Upon assigning a user to a user Group, all permissions associated with that User Group will be granted to the individual user. 

Note: Any user can exist within multiple User Groups and will have permissions drawn from the combined sets of both User Groups. 

  • For example, U-1 will have permissions A-F given:
    • U-1 is added to UG-1 and UG-2
    • UG-1 has permissions A, B, and C
    • UG-2 has permissions D, E, and F

The User Group concept also allows Site Administrators to sort and search for existing users by using "permission-less" User Groups. These 'permission-less groups' enables you to tag and organize users, for example, by their role in an organizations structure. i.e. QA User, QA Lead, Project Admin, etc. On the Licenses and Users page, Administrators can filter large lists of users by these permission-less groups.


To manage and add users to User Groups, you will need the Manage User Groups permission.

The pre-defined User Groups and their permissions are as follows:

  • Administrators: Super users who can perform any site level configurations
  • qTest Insights Viewers: Users who can view reports in qTest Insights
  • qTest Insights Editors: Users who can define reports in qTest Insights
  • qTest Pulse Users: Users who can access qTest Pulse
  • qTest Launch Users: Users who can access qTest Launch


  • Administrators who have already set up Admin Profiles do not have to worry about the introduction of User Groups, as all existing Admin Profiles will be migrated into new Custom User Groups. This way, Project Administrators will not have to start from scratch in defining new sets of user permissions. 
  • In a Sessions Only package, the only pre-defined User Group available is System Administrators. Administrators cannot modify or create new User Groups. 


Create User Groups

To create User Groups, follow these steps:

  1. In qTest Manager, select Administration in the User Profile drop-down menu. 
  2. The License Information page displays and select the Groups tab in the header menu. 
  3. The Groups page displays. Select the ADD GROUP icon located in the "Custom Groups" section. 
  4. On the Configure Group page enter your Group Name and Group Description in the corresponding text-fields. 
  5. OPTIONAL: You can set this User Group as the default for new users by selecting the "Set group as default for new users" checkbox.
  6. Under the Permissions tab, select the Group Permissions for your User Group
  7. If you want to go ahead and add users to this group now, follow the steps in the next section. If not, select Save.


Assign User Groups

Note: If you are adding users at the same time as creating your User Group, go ahead and skip to step number three.

  1. In the Administration section of Manager, select the Groups tab. The Groups page displays. 
  2. The Groups page is comprised of two sections: System Generated Groups and Custom Groups. Users can be added to either group. To assign a user to a group, select the Action icon next to the System Generated Group or Custom Group of your choice.
  3. Select the Users tab on the Configure Group page.
  4. The left column provides you with all of the users for your qTest environment. You can search for and add users by name or email.
  5. Once you find the user(s) that you want to assign to your User Group, select the checkbox next to their name(s), and select the right arrow icon to move them into the list of users in that User Group.
    INT: You can also use your tab key to select the right-arrow and the Enter key to move the usernames to the Selected column. 
  6. Select Save.


Edit Existing User Groups

Site Administrators can also edit existing User Groups. This feature allows administrators to select and de-select permissions associated with their User Groups and also add and subtract users assigned to the groups. 

Note: Administrators cannot edit the permissions associated with System Pre-defined User Groups, but can only add and subtract assigned users.

To edit User Groups, follow these steps:

  1. In Administration, select the Groups tab and the User Groups page displays. 
  2. Locate the User Group that you want to edit.
  3. Select the Action icon for that group, and select edit. 
  4. The Configure Group page displays, and from here you can change the properties of the User Group.
  5. Select Save.

Filter Users by User Groups

User Groups feature also allows administrators to search for an individual user or groups of users by using their associated User Group(s) as a filter. To do so, follow these steps:

  1. In Administration, select the Licenses tab and the License Information page displays. The page contains a list of licensed qTest users. 
  2. In the list of usernames, there is a column header called 'Groups' that will display the group(s) an individual user is associated.
  3. To filter users by User Group(s)select the Groups drop-down menu located in the action header under the License Information section.
  4. Select the checkbox(es) associated with the User Group(s) you want to use as your filter.
  5. The License Information page then populates the users assigned to the User Group(s) you selected.


Delete a User Group

Site Administrators can delete User GroupsTo do so, follow these steps:

Note: Only Custom User Groups can be deleted. Admins cannot delete System Pre-defined User Groups.

  1. In Administration, select the Groups tab and the User Groups page displays.  
  2. In the Custom Groups section of the page, locate the Custom User Group from the list that you want to delete.
  3. Select the Action icon for that User Group, and select Delete.

Use Case

Using Permissionless Groups

I am a Site Administrator and in charge of several hundred users. Within this large group of users, there are several teams, each defined by their roles within projects. One of these teams is the development team.

To better manage this team, I want to group them together in a User Group within qTest. This Group has nothing to do with the permissions that each user has, but rather serves as a sorting tool so that I can separate these developers from another team of users.

So, I create a User Group, name it Developers, describe this group as “Our development team,” and I do not set any permissions.



Powered by Zendesk