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

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

Overview

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

How to modify an account

To modify an account:

  1. Select a domain from the Account Selection list.
    • You can also search for accounts by domain or user. To search, type keywords into the appropriate Account Search text box.
  2. Click Modify. A new screen will appear.
  3. Make changes to the settings described in the sections below.
  4. 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 DomainUse the text box to enter a new primary domain.
Username

This value is used to log in to the cPanel interface and other services. Use the text box to enter a new username. Accounts may have a username of eight characters or less, or 16 characters or less if database prefixes are disabled. (MySQL imposes this limitation, since each cPanel user is also a MySQL user.) You can disable database prefixes from the Disable Database Prefix interface. 

Note:

Reseller usernames cannot be changed. 

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.

Account Owner

Use the menu to select a new account owner from the list of resellers.

Note:

Although the new reseller may have a shared IP address, the reassigned account will remain on its current IP address. The account's IP address will *not* change to the new owner's shared IP address.

Contact EmailUse the text box to enter a new contact email for the Account Owner.
Default LocaleUse the menu to select a new default locale.
cPanel ThemeSelect a theme from the menu.
  • Choose x3 for accounts that will host websites.
  • Choose x3mail for accounts that will only function as mail servers.

Warning

Several issues may arise when you change the username of an account. Websites and databases that are associated with the account may become unusable while the data is transferred to the new username. When you change the username on an account, the following areas are affected:

  • The home directory is renamed.
  • MySQL databases are copied to a new database, and the original database is removed.
    • If the database is large, the copy process can last a while. During this process, the database will be unavailable.

You should verify the account’s integrity after the transfer is complete.

After the home directory is renamed and the MySQL databases are copied, the websites and databases that are associated with the account will be usable again.

Resource limits

This section allows you to edit the following options:

OptionDescription
PackageDefines the limitations of the account. Click Change to be directed to the Upgrade Downgrade an Account interface.
Disk Quota (MB)Defines the amount of space on the server’s hard drive that the account is allowed to use. This option is defined in Megabytes (MB).
Monthly Bandwidth Limit (MB)Defines the amount of data that the account is allowed to transfer each month. This option is defined in Megabytes (MB).
Email AccountsDefines the maximum number of email accounts for the account.
FTP AccountsDefines the maximum number of FTP accounts for the account.
Mailing ListsDefines the maximum number of mailing lists for the account. Mailing lists are handled by the Mailman application. More information about Mailman is available in the Mailman documentation.
SQL DatabasesDefines the maximum number of both MySQL and PostgreSQL databases for the account.
SubdomainsDefines the maximum number of subdomains for the account.
Parked DomainsDefines the maximum number of parked domains for the account.
Addon DomainsDefines the maximum number of addon domains for the account.
Maximum Hourly Email by Domain Relayed

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

Note:

This option sets the same limit for every domain on the account. To set different limits for each domain, you must access 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 hourDefines 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.

Privileges

This section allows you to edit the following options:

OptionDescription
Reseller PrivilegesSelect this checkbox to give the account access to reseller privileges. Deselect to disable access to reseller privileges.
CGI PrivilegeSelect this checkbox to give the account the ability to serve CGI files. Deselect to disable the ability to serve CGI files.
Shell AccessSelect this checkbox to enable SSH access for the account. Deselect to disable SSH access to the server.

DNS settings

This section allows you to edit the following options:

OptionDescription
Enable DKIM on this accountSelect this checkbox to create DKIM records for all zones on this account. Deselect the checkbox to disable DKIM and delete all DKIM records on the account.
Enable SPF on this account

Select this checkbox to create SPF records for all zones on this account. Deselect the checkbox to disable SPF and delete SPF records on the account. 

Note:

cPanel & WHM uses a default SPF record of  v=spf +a +mx+ipv4:local_address ?all . 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.

Note

  • 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.
  • More information about package extensions is available in the Package Extensions documentation.

Remember:

You may not use the WHM interface to add or remove installed extensions from an existing package. If you wish to use a different set of extensions, you may either Add a Package or use API calls to Modify Package Extension Data. To change the package that is associated with an account, use Upgrade Downgrade an Account feature.

Remove uninstalled extensions

If any of the account's extensions are not currently installed on the server, a warning message will appear. You must install the missing extensions before you can edit their values.

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

  1. Select the Remove missing extensions from package box.
  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 click Cancel to return to the Modify an Account page.
OptionDescription
Upgrade/downgrade the account to a package that matches the new properties:Changes the package assigned to this account to a package that matches the settings you have chosen. This option will be visible only if one or more matching packages exist. Select the desired package from the menu.
Create a new package with this name:Creates a new package with the settings you have chosen for the account. The account will be upgraded or downgraded to this package. The default name for the new package is oldpackagename_accountname, or you can 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 new settings will be applied to  all  accounts on this package.

Set this account to have no package.

The account will not be associated with any package.

Note:

If you choose this option, current package extensions will still be associated with the account, since package extension data is saved in the  userdata  file.

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

The account will still be associated with the current package, but the settings in the userdata file will not match the settings in the package file. 

Warning:

This option is  not  recommended, since the chosen account settings could be easily overwritten by the package settings.