Manage Team

Valid for versions 118 through the latest version

Version:

110

112

118


Last modified: May 9, 2024

Overview

Note:

If the Manage Team feature does not appear, ask your hosting provider to enable it in WHM’s Feature Manager interface (WHM » Home » Package » Feature Manager).

The Manage Team interface (cPanel » Home » Preferences » Manage Team) allows the team owner to create and manage team users as part of the Manage Team feature.

Team users

The team owner is the cPanel account that owns the team. A team user is a virtual account that operates under the team owner’s account. A team owner can create the following types of team user accounts:

User
Description
Team user without role A team user without a role can:
  • Log in to cPanel.
  • Update their password.
  • Change the default interface language.
  • Update their contact information.
  • Access services that the team owner assigns.
A team owner can create an unlimited number of team users without roles.
Team user with role A team user with roles can:
  • Log in to cPanel.
  • Update their password.
  • Change the default interface language.
  • Update their contact information.
  • Access services that the team owner assigns.
  • Perform the role’s associated administrative functions.
A team owner can only assign roles to seven team users.


The Manage Team interface displays the number of current team users with roles and the maximum number of team users with roles you can create in the account quota status box:

The default maximum number of team users with roles is seven. Only a root user can adjust this value to a lower number. For more information, read our documentation on WHM’s Edit a Package interface (WHM » Home » Packages » Edit a Package).


Roles

The Roles column displays the roles assigned to the team user. Assigning a team user a role allows the team user to manage various aspects of the cPanel account. You can assign a team member multiple roles. You may only assign roles to a maximum of seven team users.

The following roles are available for team users:

Role Description
Administrator The administrator role includes all privileges of the other team user roles.
Database This role enables a team user to access tools and modify files related to database management for the team owner’s cPanel account.
Email This role enables a team user to access tools and modify files related to email administration for the team owner’s cPanel account, such as email routing and mailing lists.
Web This role enables a team user to access tools and modify files related to website functionality, such as Sitejet Builder, Wordpress Toolkit, and bandwidth usage.

Services

The Services column displays the services assigned to the team user. Team owners can give team users access to the following services:

Services
Description
Email This service gives the team user access to email for the cPanel account.
FTP This service gives the team user access to website files for the cPanel account. This service is only available if your hosting provider has enabled it.
Web Disk This service allows the team user to manage and manipulate files on your server in multiple types of interfaces (for example, your computer, mobile device, or certain types of software).

For more information, read our Create a Team User interface (cPanel » Home » Preferences » Manage Team » Create a Team User) documentation.

Create a team user

To create a team user, click Create Team User. A new interface will appear. In the Create a Team User interface (cPanel » Home » Preferences » Manage Team » Create a Team User) you can create a new team user, and assign the new user services and roles.

For more information, read our Create a Team User interface documentation.

List team table

This table lists all of team users associated with your Manage Team account. Click a column’s heading to sort the results of the table by that heading. The table will sort the list in ascending or descending order.

The table contains the following information:

Item
Description
Username The team user’s login username. If the team user is suspended, the Suspended ( ) warning will appear next to the team user’s username. Click the More (More) icon to view more information about a team user account. This will display the team user’s information.
Roles The team user’s assigned role(s) if applicable.
Last Login Date The last time the team user logged in to the account.
Services The services available to the team user.
Actions The actions available to manage the team user.

Team user information

Item
Description
Restriction Information If the team user is suspended, the interface will display the date of the suspension and the reason for the suspension. If the team user is set to expire on a specific date, the interface will display the date of the expiration and the reason for the expiration. If the team owner does not provide a reason for suspension or expiration, these fields will be blank.
Account Information The team user’s login username, relevant notes about the team user, the last login date, and the creation date of the account. The interface will display the time and date according to the team owner’s locale.
Team Information The roles assigned to the team user.
Security Information The contact email address for the team user.

Actions

Each team user has the following actions available:

Actions Description
Edit User To edit an existing team user, click Edit User in the Actions section. A new interface will appear. A team owner can edit details such as password settings and roles for a team user.
For more information, read our Edit a Team User documentation.
Suspend To block a user from accessing the account, the team owner can suspend the team user.
Warning:
  • Suspension will prevent that user from accessing anything from within the cPanel interface.
  • You cannot change the password for a suspended team user.
  • Suspended users will count towards the maximum allowed accounts for Manage Team if they have a role assigned.
  • To suspend a team user, click Suspend in the Actions section.
  • To remove a team user from suspension, click Unsuspend in the Actions section.
Delete Deleting a team user will remove that user from the team. Deleted users will not count against the maximum number of accounts for Manage Team.
Warning:

You cannot undo this action.

To delete a team user, perform the following steps:
  1. Locate the team user in the list and click Delete. A confirmation window will appear.
  2. To confirm, click Delete.

View audit log

Note:

To view the Audit Log, your system administrator must select the Enable cPanel API Log setting in the Tweak Settings interface (WHM » Home » Server Configuration » Tweak Settings » Logging).

The Audit Log feature allows team owners to track team user actions that use cPanel’s API. The audit log table contains the following information:

Item
Description
Timestamp The date and time when the user made the API call.
Called By The cPanel account or team user’s username.
API Version The version of the API used.
Call The API call made by the user.
Origin The API call’s origin in either the terminal or the user interface.

For more information about how cPanel’s audit log, read our Audit Log documentation.

Additional Documentation