Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.44

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

Overview

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 described in the sections below.
  3. Click Save.

    Note:

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

Basic Information

This section allows you to edit the following options:

OptionDescription
Primary DomainEnter a new primary domain.
Username

Enter a new username.

Warning:

  • 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 will cause 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 will rename the user's home directory.
  • Make certain to verify the account’s integrity after the transfer is complete.

Important:

  • Choose a username that contains 16 characters or less.
  • To prevent issues with database prefixing and account transfers, the first eight characters must be unique on the system.

Notes:

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 will change 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.

Important:

  • 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 will cause errors in applications that depend on the previous names.
  • If you do not rename the prefixed databases and database users, PostgreSQL users will not be able to log in until they reset their passwords.
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.

 

Resource Limits

This section allows you to edit the following options:

OptionDescription
PackageDefines the limitations of the account. Click Change to go to the Upgrade/Downgrade an Account interface (Home >> Account Functions >> Upgrade/Downgrade an Account).
Disk Quota (MB)Defines the amount of space on the server’s hard drive for the new account, in Megabytes (MB).
Monthly Bandwidth Limit (MB) Defines the maximum amount of data that the new account can transfer each month, in Megabytes (MB).
Email AccountsDefines the maximum number of the new account's email accounts.
FTP AccountsDefines the maximum number of the new account's FTP accounts.
Mailing Lists

Defines the maximum number of the new account's mailing lists.

Note:

The Mailman application handles mailing lists. For more information, read the Mailman documentation.


SQL DatabasesDefines the maximum number of the new account's MySQL ® and PostgreSQL databases.
SubdomainsDefines the maximum number of the new account's subdomains.
Parked DomainsDefines the maximum number of the new account's parked domains.
Addon DomainsDefines the maximum number of the new account's addon domains.
Maximum Hourly Email by Domain Relayed

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

  • This value defaults to Unlimited.
  • A value of 0 signifies Unlimited

Note

This option sets the same limit for every domain on the account. To set different limits for each domain, use the build_maxemails_config script from the command line. If you set different limits for each domain, default will display the limit set for the account's primary domain. For more information, read our How to Set Email Send Limits documentation.

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 can send before your server temporarily blocks outgoing mail from that domain.

  • 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. 
  • The default value is unlimited.

 

Privileges

This section allows you to edit the following options:

OptionDescription
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:

OptionDescription
Enable DKIM on this account

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

Note:

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.

Notes:

  • 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.


 

Package Extensions

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

Notes:

  • Only package extensions that you included in the chosen package will appear in this section. To find out 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 (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 (Home >> Account Functions >> Upgrade/Downgrade an Account).
  • For more information about package extensions, read our Package Extensions documentation.

Remove missing extensions from package

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

Warning:

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 will appear. 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 click Proceed. You can choose one of the following options:

OptionDescription
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 is only visible if one or more matching packages exist. Select the desired package from the menu.
Create a new package with this nameCreates a new package with your chosen settings. The system will upgrade or downgrade the account to this package. The default name for the new package follows the oldpackagename_accountname format, where oldpackagename is the name of the account's previous package, and accountname is 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.

Warning:

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

Set this account to have no package

The system will not associate the account with a package.

Note

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

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

The system will continue to associate the account with its current package, but the settings in the account's userdata file will not match the settings in the package file.

Warning:

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