Valid for versions 110 through the latest version
Last modified: March 8, 2023
The List Accounts interface displays your server’s accounts and allows you to perform certain actions on them.
If your hosting provider enables the Create Accounts privilege in WHM’s Edit Reseller Nameservers and Privileges interface (WHM » Home » Resellers » Edit Reseller Nameservers and Privileges), this interface will display a link to WHM’s Create a New Account interface (WHM » Home » Account Functions » Create a New Account).
Search for accounts
The search text box and filters allow you to refine the list of accounts using the following options:
Search For – To search for accounts using a specific keyword, enter a search term in the search text box.
Search By – To search for accounts using one the following options, select the corresponding button:
- Username/Domain — Search for a username or domain name that contains your search term.
- Domain — Search for a domain name that contains your search term.
- Username — Search for a username that contains your search term.
- Reseller/Owner — Search a reseller or owner name that contains your search term.
- Package — Search for a package name that contains your search term.
- IP Address — Search for an IP address that contains your search term.
Filter By — To filter the list of accounts using one the following filters, select the corresponding button:
- None — Do not apply an additional filter.
- Suspended — Include only accounts that are currently suspended.
- Upgrade Opportunity — Include only accounts that have used a high amount of bandwidth or disk space. For more information about the messages in the Upgrade Opportunities column, read the Upgrade Opportunities section below.
To list accounts using your entered search term and selected filters, click Find or Apply Filter. To clear your search, click Reset.
The table of accounts lists detailed information about each account on your server, and allows you to perform the following actions on each account:
Click the plus icon () to view the available actions for the associated account. For more information, read the Actions section below.
Click a domain name in the Domain column to navigate to that site.
Click the cPanel logo () in the cPanel column to log in to the cPanel interface for that account with the
rootor reseller password.Note:
If you disabled
rootor reseller logins to cPanel user accounts, this icon does not display. You can enable this feature in the System section of WHM’s Tweak Settings interface (WHM » Home » Server Configuration » Tweak Settings).
This feature uses the Internal Session Tool and Single Sign On system to generate a temporary user. For more information, read our Guide to API Authentication documentation.
Click the IP address in the IP Address column to view the contents of the user’s home directory in a new browser tab.
Click the email address in the Contact Email column to send an email to the account’s owner.
Click the account’s assigned package (for example, default) in the Package column to open the Edit a Package interface (WHM » Home » Packages » Edit a Package).Note:
A red warning icon () and Unknown appear in the Package column if the account does not have an assigned package.
When you use any of these actions to navigate to another WHM interface, WHM automatically selects the correct account.
When you expand the information for an account, you can perform the following additional actions:
Change Password — To change an account’s password, enter the desired password, select the desired options, and click Change.
Select the Synchronize MySQL password with account password checkbox if you want to use the same password for the user’s MySQL® account.Note:
This option is only available for users who possess an installed
Select the Enable Digest Authentication checkbox to enable Digest Authentication support.
Change Contact Email — To change the contact email address for the account, enter a new address in the text box and click Change.Important:
The Reset Password feature uses this email address to verify the account user’s identity. If you do not set the contact email address, the user cannot use the Reset Password feature.
Suspend Account – To suspend an account, enter a reason in the text box and click Suspend. To ensure that resellers cannot unsuspend the account, select the Prevent unsuspending checkbox.Important:
If you suspend a team owner’s account, you will also suspend each team user connected to that account. Once you remove the team owner’s account from suspension, you will return the team users to their previous state before the suspension. For more information on team owners and team users, read our Manage Team documentation.
Account Suspended — Suspended accounts appear with the following information:
- Reason — Displays the reason for account suspension, if the WHM user who suspended the account entered a reason.
- Suspended — The date and time of the suspension.
- Suspension Locked — Displays whether a system administrator has locked the suspension. Only the
rootuser or users with
root-privileges can unsuspend a locked account.
- Unsuspend — To unsuspend an account, click Unsuspend.
- Retain Service Proxying — To keep service proxying, select the Retain Service Proxying checkbox. Most users do not need to select this checkbox.
Change IP Address — Click Change IP Address to navigate to WHM’s Change a Site’s IP Address interface (WHM » Home » IP Functions » Change a Site’s IP Address), where you can change the account’s IP address.
Change Disk Partition — Click Change Disk Partition to navigate to WHM’s Rearrange an Account interface (WHM » Home » Account Functions » Rearrange an Account), where you can change which home directory stores the account.
Change Quota — Click Change Quota to navigate to WHM’s Quota Modification interface (WHM » Home » Account Functions » Quota Modification). You can use this interface to change the maximum amount of disk space that the account can use on your server.Important:
When you change a quota, we recommend that you first examine the contents of the account to ensure that the account does not already exceed the quota. If this is the case, we recommend that you request the owner of the account to remove files to comply with the new disk quota.
Change Plan — Click Change Plan to navigate to WHM’s Upgrade/Downgrade an Account interface (WHM » Home » Account Functions » Upgrade/Downgrade an Account), where you can change the account’s package.
Modify Account — Click Modify Account to navigate to WHM’s Modify an Account interface (WHM » Home » Account Functions » Modify an Account), where you can make changes to the account.
The following types of messages can appear in the Upgrade Opportunities column:
||This cPanel account recently exceeded its bandwidth limits or disk usage limits.||Consider upgrading the cPanel account’s hosting plan.|
||This cPanel account recently used most of its bandwidth limits or disk usage limits.||Consider upgrading the cPanel account’s hosting plan.|
||This cPanel account has recently used a high amount of disk space.||Consider upgrading from a shared hosting plan to a virtual private server (VPS) hosting plan. For more information about VPS hosting plans, contact your hosting provider.|
When you click Download these records to a CSV file, WHM automatically downloads a
.csv file. This file displays the information from the List Accounts table as a comma-separated list.