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.

IMPORTANT: User Groups are different from User Profiles. User Profiles affect permissions at the project-level while User Groups affect permissions at the site-level.

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.


Individual Group Level Permissions

When configuring a User Group, you can set individual group level permissions (as seen in the above screenshots). The permissions associated with each are the following:

  • Application Access: When a user is added to qtest, they automatically have access to Manager and Parameters, but they won’t have access to Insights, Pulse or Launch unless configured below.
    • Insights Viewer: When checked by itself, it is a read-only license for Insights. Users can only view pre-built and custom reports, but they cannot change the content of these reports
    • Insights Editor: This permission requires viewer access. It allows users to create and view reports within Insights.
    • Pulse User: viewing and editing access within Pulse
    • Launch Viewer: read-only access within qTest Launch
  • Manager Permissions: When a user is added to qtest, they can be assigned to an Admin profile (user group) to manage items within each one of the Admin tabs. This section is Manager-related only.
    • Create Projects: Allows the Admin to create new projects in the system. The add-new-project and clone-from-existing-project buttons become available, but editing is not allowed. It gives access to the Projects, project Groups and Reports Tab.
    • Edit Projects: Allows user to edit project info, such as name of project, date, project admin, etc. Because the user can edit projects, they are also able to create new projects and clone. The project name will turn blue in the list, indicating editing is allowed. It gives access to the Projects, Project Groups and Reports Tab.
    • Archive projects: Allows user to Delete Projects. The list has now an “x” by the Action column, indicating the ability to delete the project. It gives access to the Projects, Project Groups and Reports Tab.
    • List Projects: gives the ability to view the list of projects that have been added to the system but creation, cloning or deletion of projects is not available.
    • Edit User Profiles: Allows admin to create new user profiles. It gives access to add, edit and delete user profiles (except for the out of the box profiles). User profiles, Project Groups and Reports tab are shown for the admin that has this permission.
    • View User Profiles: Allows admin to view user profiles. They cannot add a new one, nor edit or delete existing ones. Though they push updated profiles to existing projects by using save-&-apply option. It gives access to User Profiles, Project Groups, and the Reports tab
    • Manage Site Fields: gives access to add, edit and push new fields to multiple projects. A way to manage fields at the admin level. However, it does not work when selected by itself. You MUST use another item from the Manage Permission section for this to work (such as create projects).
  • Global Permissions: manage permissions at the global level. This section refers to more administrative items, such as company profile name, SSO integration access, password policy, etc.
    • Manage Client Users: all the Manager permissions become selected (see the previous section to determine what permissions have been added).
    • Manage Client Info:  admin only has access to the client info page.
    • Manage System Configuration: gives access to the Authentication, Configurations, Projects Groups, Reports and Configuration Field Settings Tab.
    • Manage User Groups: gives access to Groups, Project Groups, and the Reports Tab.

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