Table of Contents

Managing user permissions and roles

TestRail's permission and role system allows you to configure and restrict the project access and permissions of individual users and groups. TestRail comes with built-in roles that can be customized and extended. It is also possible to configure per-project access for users and groups, enabling you to customize TestRail's access control for your needs.

You can manage users & permissions in the administration area under Administration > Users & Roles in TestRail.

Configuring roles

Roles within TestRail are collections of permissions that can be assigned to users (globally and per project) and groups (per project). TestRail already comes with a few preconfigured useful roles such as Guest, Tester or Lead. You can also change the built-in roles or add your own ones. To configure TestRail's roles, select Administration > Users & Roles.

One role is always the default role in TestRail. The default role is used as a fallback in case you delete roles that are still in use. The default role is also preselected if you add additional users to TestRail.

Assigning roles

Every user has a global role assigned to her. The global role is usually used if you don't specify the access of a user for a specific project. For example, if you choose the built-in Tester role as the global role for a user, the user can add test results to all projects that use the global role as the default access.

To change the global role of a user, you can either select the role on the Users & Roles page or change the role when you edit a user account.

Please note that you can also assign roles (and thus restrict permissions) to administrators. This can be useful if an administrator wants to hide specific projects or disable some functionality in her user interface. But remember that an administrator can always change her own role, so you cannot count on roles to enforce permissions for administrators.

Assigning groups

Groups can be used to manage a collection of users, e.g. a team of testers, geographical teams or users that belong to a specific client or customer. You can define and configure groups under Administration > Users & Roles.

Project access

You can also specify and override the access for specific projects. To do this, just edit a project in the administration area and select the Access tab. There are two things you can do here: you can specify the Default Access for the project and you can assign the access for specific users or groups. The Default Access is used for all users and groups that don't override the project access.

For example, by default, all users have permissions according to their global role (when the Default Access for a project is set to Global Role). However, you can also select that no user should have a access to a project (i.e. No Access as Default Access), unless you override the access for a user. You can also use a role as the default access for a project. This allows you to make a project read-only for all users by default, for example.

You can also override the project access for specific groups of users and this applies the configured access/permissions to all users of this group. For example, if you assign Global Role to a group, all users of this group will use their global role. Likewise, if you assign No Access, the users of this group won't have access to this project. If a user is a member of multiple groups, TestRail uses the sum of the permissions of those groups. Please note that the user access for the project (if any) has precedence over the group settings.

The combination of global roles, default project access and user/group-specific access for projects makes TestRail's roles and permissions system very flexible. Please see the next section for some examples on how to configure TestRail for typical scenarios.

Common scenarios

The following examples explain how to configure TestRail to accomplish some common scenarios with regards to roles and permissions.