We have a new documentation site for cPanel & WHM! You can find our new documentation site at docs.cpanel.net.

We will continue to maintain our API documentation on this server.

Child pages
  • Modify an Account
For cPanel & WHM version 76

Skip to end of metadata
Go to start of metadata

(WHM >> Home >> Account Functions >> Modify an Account)


The Modify an Account interface allows you to make changes to an existing account.

Modify an account

To modify an account, perform the following steps:

  1. Select the desired account and click Modify.
  2. Make changes to the settings in the sections below.
  3. Click Save.


    If you make changes to the Resource LimitsPrivilegesDNS Settings, or Package Extensions sections, the Package Conflict Resolution dialog box appears.

Basic Information

This section allows you to edit the following options:

Primary DomainEnter a new primary domain.

Enter a username. The new username must meet the following requirements:

  • You must choose a unique username that contains 16 characters or fewer.
  • The username must contain only letters and numbers.
  • The username cannot start with a number or the string test.
  • If you plan to use MySQL or PostgreSQL as a database engine, the first eight characters must be unique on the system to prevent issues with database prefixing and account transfers. However, this restriction does not apply to servers that run MariaDB.


    You can disable database prefixing with the Add prefix to names of new databases and database users option in the SQL section of WHM's Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings).

  • For more information about username restrictions, read our Reserved, Invalid, and Misconfigured Usernames documentation.


  • If you must change the account username, we recommend that the new name be the same length or shorter. A longer name may cause MySQL® to truncate the account's database names and database usernames, which causes problems.
  • If you change the username of an account, the following problems may occur:

    • You cannot use the associated websites and databases while the data transfers to the new username.
    • The system renames the user's home directory.
  • Make certain to verify the account’s integrity after the transfer finishes.


You cannot change resellers' usernames.

Rename prefixed databases and database users

The system selects the Rename prefixed databases and database users checkbox by default. If database prefixing is active on the server, this function changes the names of associated database objects (databases and database users) to use the first eight characters of the new username as a database prefix. For example, if you change the example username to example1, the system will rename the example_db database to example1_db and the fred_db1 user to example1_db1, but name of the steve database will not change.

Deselect this checkbox to rename only the cPanel account itself.


  • When you rename an account, you can rename the account’s databases and database users to preserve the visual correspondence between database names and the username. However, this causes errors in applications that depend on the previous names.
  • If you do not rename the prefixed databases and database users, PostgreSQL® users cannot log in until they reset their passwords

MySQL does not allow you to rename a database. When cPanel & WHM "renames" a database, the system performs the following steps:
  1. The system creates a new database.
  2. The system moves data from the old database to the new database.
  3. The system recreates grants and stored code in the new database.
  4. The system deletes the old database and its grants.


  • If any of the first three steps fail, the system returns an error and attempts to restore the database's original state. If the restoration process fails, the API function's error response describes these additional failures.
  • In rare cases, the system creates the second database successfully, but fails to delete the old database or grants. The system treats the rename action as a success; however, the API function returns warnings that describe the failure to delete the old database or grants.

Account OwnerSelect a new account owner from the list of resellers.
Contact EmailEnter a new contact email for the account's owner.
Default LocaleSelect a new default locale.
cPanel Theme

Select a theme from the menu.


To modify the theme and associated style for multiple accounts, use the /scripts/modify_accounts script. 

Enable Apache SpamAssassin™

Enable or disable Apache SpamAssassin's Spam Filters for the account. 


You cannot modify this setting if you enable the Apache SpamAssassin™: Forced Global ON setting in WHM's Exim Configuration Manager interface (WHM >> Home >> Service Configuration >> Exim Configuration Manager).

Manual Resource Options

This section allows you to edit the following options:

PackageSelect a hosting plan, which defines the limitations of the account. Click Change to navigate to the Upgrade Downgrade an Account interface (WHM >> Home >> Account Functions >> Upgrade/Downgrade an Account).
Disk Quota (MB)Enter the amount of space on the server’s hard drive for the new account, in Megabytes (MB).
Monthly Bandwidth Limit (MB)Enter the maximum amount of data that the new account can transfer each month, in Megabytes (MB).
Email AccountsEnter the maximum number of the account's email accounts.
Max Quota per Email Address (MB)

Enter maximum size that the account can define when it creates an email account, in Megabytes (MB).


When you adjust this value it does not affect existing email accounts.

FTP AccountsEnter the maximum number of the account's FTP accounts.
Mailing Lists

Enter the maximum number of the account's mailing lists.


The Mailman application handles mailing lists. For more information, read Mailman's overview documentation.

SQL Databases

Enter the maximum number of each available type of SQL database.

For example, if you set this value to 5 and allow MySQL® and PostgreSQL databases, the account can create up to five MySQL databases and up to five PostgreSQL databases.

SubdomainsEnter the maximum number of the account's subdomains.
Parked DomainsEnter the maximum number of the account's parked domains (aliases).
Addon DomainsEnter the maximum number of the account's addon domains.
Passenger Applications

Enter the maximum number of the account's Ruby applications.

Maximum Hourly Email by Domain Relayed

Enter the maximum number of emails that a domain can send per hour.

  • This value defaults to Unlimited.
  • A value of Set this value to 0 to allow unlimited outbound emails.


This option sets the same limit for every domain on the account.

  • To set different limits for each domain, read our How to Set Email Send Limits documentation.
  • If you set different limits for each domain, default displays the limit that you set for the account's primary domain.
Maximum percentage of failed or deferred messages a domain may send per hour

Defines the maximum percentage of failed or deferred messages that a domain sends before your server temporarily blocks outgoing mail from that domain.

  • This value defaults to Unlimited.
  • The system examines outgoing and local mail over the previous hour to determine whether the domain exceeds the limit. 
  • When a domain exceeds the limit, it cannot send mail until the domain no longer exceeds the limit.


This section allows you to edit the following options:

Reseller PrivilegesSelect this checkbox to grant reseller privileges to the account.
CGI PrivilegeSelect this checkbox to grant the ability to serve CGI files to the account.
Shell AccessSelect this checkbox to enable SSH access for the account.

DNS Settings

This section allows you to edit the following options:

Enable DKIM on this account

Select this checkbox to create DKIM records for all of the account's zones.


If you disable DKIM, the system will delete any existing DKIM records on the account. 

Enable SPF on this account

Select this checkbox to create SPF records for all of the account's zones.


  • If you disable SPF, the system will delete any existing SPF records on the account. 
  • cPanel & WHM uses v=spf +a +mx+ipv4:local_address ?all as the default SPF record.
    • Add a custom SPF record to the appropriate DNS zone template to override this setting.
    • If the account's owner has also enabled SPF, the system automatically rewrites this record when you use WHM's Assign IPv6 Address interface (WHM >> Home >> IP Functions >> Assign IPv6 Address) to assign an IPv6 address.


The /scripts/enable_spf_dkim_globally script allows you to enable SPF and DKIM for accounts that exist on the server, and to create the appropriate DNS records for their domains. For more information, read our The enable_spf_dkim_globally Script documentation.

Package Extensions

If you included any package extensions with the account or its package, a Package Extensions section displays at the bottom of the interface. Some extensions may include variables that you can edit. Any options or settings that you can edit appear below the extension name.


  • Only package extensions that you included in the chosen package appear in this section. To learn more about extension options and how to change them, consult the extension's documentation.
  • You cannot use the WHM interface to add or remove installed extensions from an existing package. 
    • To use a different set of extensions, use the Add a Package interface (WHM >> Home >> Packages >> Add a Package) or use API calls to modify package extension data.
    • To change the account's package, use the Upgrade/Downgrade an Account interface (WHM >> Home >> Account Functions >> Upgrade/Downgrade an Account).

Remove missing extensions from package

If any of the account's extensions are not currently installed on the server, a warning message appears.


You must install the missing extensions before you can edit their values.

If you do not wish to install the missing extensions, perform the following steps to remove them from the account's chosen package:

  1. Select the Remove missing extensions from package checkbox.
  2. Click Save Changes to remove the extensions from the package.
  3. The Package Conflict Resolution dialog box appears. Select the desired option and click Proceed.

Package Conflict Resolution

The Package Conflict Resolution dialog box appears if you attempt to save settings that do not match the account's assigned package. 

If the Package Conflict Resolution dialog box appears, select the desired option and then click Proceed. You can choose one of the following options:

Upgrade/downgrade the account to a package that matches the new propertiesChanges the account's package to a package that matches your chosen settings. This option only appears if one or more packages that match exist. Select the desired package from the menu.
Create a new package with this name

Creates a new package with your chosen settings.

  • The system upgrades or downgrades the account to this package.
  • The default name for the new package follows the oldpackagename_accountname format, where oldpackagename represents the name of the account's previous package, and accountname represents the account's name. You can also enter a new package name.
Update package (package name) with these new values

Updates the current package to the chosen settings.


If you choose this option, the system applies the new settings to all of the accounts that use this package.

Set this account to have no package

Dissassociates the account from a package.


If you choose this option, the system continues to associate the account with the current package extensions, because the system stores package extension data in the account's userdata file.

Keep this account on package (package name) (not recommended)

Continues to associate the account with its current package, but the settings in the account's userdata file do not match the settings in the package file.


We do not recommend that you use this option, because the system could easily overwrite the chosen account settings with the package settings.

Additional documentation

There is no content with the specified labels

There is no content with the specified labels

There is no content with the specified labels