- Getting started
- Project management
- Documents
- Working with Change Impact Analysis
- Create test cases
- Assigning test cases to requirements
- Cloning test cases
- Exporting test cases
- Linking test cases in Studio to Test Manager
- Delete test cases
- Manual test cases
- Importing manual test cases
- Document test cases with Task Capture
- Parameters
- Enabling governance at project level
- Disabling governance at project level
- Enabling governance at test-case level
- Disabling governance at test-case level
- Managing approvers for governed test cases
- Managing governed test cases in the In Work state
- Managing governeed test cases in the In Review state
- Managing governed objects in the Signed state
- Managing comments for governed test cases
- Applying filters and views
- Importing Orchestrator test sets
- Creating test sets
- Adding test cases to a test set
- Assigning default users in test set execution
- Enabling activity coverage
- Enabling Healing Agent
- Configuring test sets for specific execution folders and robots
- Overriding parameters
- Cloning test sets
- Exporting test sets
- Applying filters and views
- Accessibility testing for Test Cloud
- Searching with Autopilot
- Project operations and utilities
- Test Manager settings
- ALM tool integration
- API integration
- Troubleshooting
Test Manager user guide
Access management is handled by the Test Manager Administrator that can assign tenant roles to users and groups, as well as create custom project roles, and Project Owners that can assign project roles to users and groups.
In Test Manager, there are two types of roles available:
- Tenant - these roles are relevant at tenant level.
- Project - these roles are relevant at project level.
Conditions
To assign users and groups to projects, first you need to ensure that the Test Manager service is enabled in the tenant where you want to use it. Secondly, you need to allocate licenses for your users. For more information, see Enabling Test Manager in Automation CloudTM.
- Users that are signed in cannot be removed until they sign out.
Tenant roles
Tenant roles define the actions that a user or group can perform in the target tenant, regardless of the project roles they have assigned. These roles involve the ability of creating projects, creating custom roles, and assigning roles to users or groups.
The table below shows the available tenant roles and their corresponding descriptions.
| Tenant role | Description |
|---|---|
| Test Manager Administrator | A Test Manager administrator can perform the following actions:
|
| Project Creator | A Project Creator can create testing projects. If you want non-administrator users to create projects without granting them administrator privileges, you can assign them only the Project Creator tenant role. |
Project roles
Project roles define the actions that a user or a group can perform inside a testing project, such as create manual test cases, or execute tests.
The table below shows the available project roles and their permissions.
| Privileges | Project owner | Test Manager | Test Designer | Test Executor | Manual Tester | Performance Tester | Viewer |
|---|---|---|---|---|---|---|---|
| Update, and delete projects (Read, Edit, Delete) | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Create projects | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| View projects (Read) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Assign users and groups to projects | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Access to project settings | ✅ | ❌(For Cloud Dedicated only) ✅(For Cloud Commercial and Cloud Public Sector only - Can only view and access the Prompt library tab) | ❌ | ❌ | ❌ | ❌ | ❌ |
| Dashboard and reports | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Create, update and delete integration connections | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| View requirements | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Create, update, and delete requirements (Create, Read, Edit, Delete) | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Assign requirements to test cases | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| View test cases (Read) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Create, update and delete test cases (Create, Read, Edit, Delete) | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Add test step to test case | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Link automation from Studio to test case | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Create, update and delete documents (attached files) | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Create, update and delete custom fields | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Create, update and delete label | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Document with Task Capture (for Cloud Commercial and Cloud Dedicated only) | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Assign test cases to test sets | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| View test sets (Read) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Create, update and delete test tests (Create, Read, Edit, Delete) | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Execute manual tests | ✅ | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ |
| Execute automated tests | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ |
| Link test set from Orchestrator | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| View test results (Read) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Update and delete test results (Create, Read, Edit, Delete) | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Create defects | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ |
| Re-execute test executions | ❌ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ |
| Create custom user roles | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Use, create, update, and delete prompts from the project's prompt library | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Searching with Autopilot | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Assign and unassign manual test case executions to users. | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Setting a default execution folder for a project | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Access live streams of test executions (for Cloud Commercial and Cloud Public Sector only) | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() | ![]() |
| Import Orchestrator test sets | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| View performance scenarios - Overview list | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| View performance scenarios (existing and running) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| View performance results | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Create performance scenarios | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ |
| Start, stop, edit, delete performance scenarios | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ |
| Test process governance | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Enable access management
Required for legacy projects only. New projects have access management enabled by default.
To manage users and groups, you need to enable access management in your Test Manager project. Open Test Manager and navigate to Project Settings > Manage access, open a project, click Enable now, and then confirm your action. Now you can start assigning users and groups to your organization's projects.
Manage user and group access
If you have a legacy project, you might need to enable access management, to start assigning users and groups to your project.
Assign Users and Groups
To assign users and groups, you can perform the following actions:
- Assign tenant-specific roles to users and groups.
- Assign users and groups to testing projects.
- Assign project-specific roles to users and groups.
Assigning tenant roles to users and groups
To manage the actions that a user or group can perform at a tenant level in terms of testing projects, you can assign tenant-specific roles to a user or group.
-
Open Test Manager.
-
Select Settings in the header.
-
Go to the Role Assignments tab.
-
Select Assign users/groups.
-
Enter a user or group in the form field. For example, you can assign roles to the Everyone group.
-
Select the tenant user roles that you want to assign. You can choose from:
- Project Creator
- Administrator
-
Select Add to confirm your action. The tenant roles are now assigned to the users and groups.

Assigning users and groups to projects
To grant users and groups read-only access to a project, you can assign them to a project, without assigning other project-specific roles to users and groups.
-
Open Test Manager.
-
Open a project.
-
Navigate to Project Settings > Manage Access.
-
Select Assign users/groups.
-
Enter a user or group in the form field. For example, you can assign access to the Everyone group.
-
Press Enter to add the user/group. You can add multiple users and groups at once.
-
Click Add to confirm your action. The users and groups are assigned to the project.

Assigning project roles to users and groups
To manage the actions that a user or group can perform inside a testing project, you can assign project-specific roles to users and groups. Visit User and group access management to see the permissions for each project role.
- Open Test Manager.
- Open a project.
- Navigate to Project Settings > Manage Access.
- Select Assign users/groups.
- Enter a user or group in the form field. For example, you can assign access to the Everyone group.
- Select the user roles that you want to assign. The roles that you can choose from are the pre-defined roles, and the custom roles that you may have created.
- Select Add to confirm your action. The selected roles are assigned to the specified users and groups.
Note:
Any user or group can be assigned or unassigned the Project Owner role. Ensure that each project has at least one user or group with the Project Owner role.
Figure 1. Pre-defined and custom roles that you can assign to users and groups at project level

Edit Individual User and Groups
You can edit roles or remove users and groups.
- Open Test Manager.
- Open a project.
- Navigate to Project Settings > Manage Access.
- Find the user or group that you want to edit and click the vertical ellipsis.
4.1 Select Edit roles to change the roles.
4.2 Select Remove user or Remove group to remove users or groups. 5. Confirm your action.
To perform a bulk operation, see Removing users and groups.
Related articles
Behavior of unlicensed users
Users invited to an organization without a Tester - Named User license can still explore Test Manager projects where they hold the Viewer role. Unlicensed users who hold the Viewer role in a project can perform the following actions:
- Open the project.
- Review and navigate through test objects, such as:
- Requirements
- Test Cases
- Test Sets
- Go to the Execution tab and view the list of grouped executions by Test Set.
Note:
Users who don't have a Tester - Named User license cannot open a test execution and view its details.
Custom roles
Creating custom roles
Create custom roles to reflect your authorization needs. Roles created and assigned in Test Manager are separated from the ones configured in Orchestrator.
Only Project owners can create custom Test Manager roles.
- Select Settings in the Test Manager header.
- In the Manage roles tab, select Create role.
- Give a name and a description for the custom role.
- Select the desired permissions for each test object:
All Test Manager users have Read permissions for all test objects selected by default, and you can't deselect it. (For Cloud Commercial only) The only exception to this rule is Autopilot prompt. Select Read permissions for it, if needed.
5. Select the tasks this role is allowed to perform:
| Task Permissions | Description |
|---|---|
| Manual execution | Allow user to perform manual execution for test cases and test sets. |
| Automated execution | Allow user to perform automated execution for test cases and test sets. |
| Create and unlink defects | Allow user to create and unlink defects. |
| Change test case executions assignments | Allow user to assign and unassign manual test case executions |
| View live stream of automated executions | Allow user to view the live stream video of an automated test execution. |
| Remotely control live stream of automated executions | Allow user to remotely control the live stream of an automated test execution. |
- Select Create. The Role created successfully message appears.
Editing custom roles
Edit custom user roles to reflect your authorization needs:
- Select Settings in the Test Manager header.
- In the Manage roles tab, select
for the user role that you want to edit, and then select one of the following actions:
- Edit role - This opens the Edit role panel and you can edit the name, description and permissions.
- Clone - This opens the Clone role panel and you can edit the clone of the role that you're creating.
- Select Save to record your changes.
Deleting custom roles
-
Select Settings in the Test Manager header.
-
In the Manage roles tab, select one or more custom user roles, and then select Delete.
-
In the Confirm dialog, select Delete.

When you delete a custom user role, it won't be assigned to any user anymore.

