Add a Package

Valid for versions 82 through 88




Last modified: September 16, 2021


This feature allows you to create a new package that you can assign to any account on your server.


Some hosting providers use the term “domain templates” to describe this concept.

Create a package

To create a package, perform the following steps:

  1. Enter the desired package name in the Package Name text box.


    You cannot modify package names. For this reason, avoid package names that include details that you may wish to change later, such as price.

    • Because the system stores packages as files, you may use any valid filename. However, to prevent conflicts with Package Extensions, you cannot name packages extensions.
    • The cPanel interface only displays the package’s name (for example, reseller_package appears as package).
    • For easier package management, create fewer packages and use short names.

  2. Enter the required information in the Resources and Settings sections. The Settings section also allows you to change settings for some third-party packages, if the package provider configured this ability. For more information on each option, see the tables below.

  3. Click Add.

Resource options

Packages can include the following resource options:

Option Description
Disk Quota (MB) The maximum amount of space on the server’s hard drive that the account can use, measured in megabytes (MB).
Consider the type of content that your users intend to host, because this greatly affects the amount of disk space that they need.
Monthly Bandwidth (MB) The amount of information that the account can transfer each month, measured in megabytes (MB).
Consider the type of content that your users intend to host, because this greatly affects the amount of disk space that they need.
Max FTP Accounts The maximum number of FTP accounts for the cPanel account.
Max Email Accounts The maximum number of email accounts for the cPanel account.
Max Quota per Email Address (MB) The maximum size that the account can define when it creates an email account, in megabytes (MB). This value defaults to Unlimited.
When you adjust this value it does not affect existing email accounts.
Max Email Lists The maximum number of Mailman mailing lists for the account. For more information, read our Mailing Lists documentation.
Max Databases 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.
Max Sub Domains The maximum number of subdomains for the account.
Max Parked Domains The maximum number of parked domains (aliases) for the account.
Max Addon Domains The maximum number of addon domains for the account.
Maximum Hourly Email by Domain Relayed The maximum number of emails that any domain on the account can send per hour. This value defaults to Unlimited. A value of 0 represents Unlimited.
Maximum Percentage of Failed or Deferred Messages a Domain May Send Per Hour The maximum percentage of failed or deferred messages that a domain on the account 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.
  • This value defaults to Unlimited.

Settings options

Packages can include the following setting options:

Option Description
Dedicated IP A static IP address that the account will not share with other accounts unless the user specifies an account with which to share an IP address.
  • You cannot edit this option after package creation. To change this setting, you must create a new package.
  • We recommend this setting for packages that you will apply to reseller accounts.
Shell Access Allows the user to access the server through a command line interface.
We recommend that you provide jailshell user environments if you grant your users shell access. For more information, read our VirtFS - Jailed Shell documentation.
CGI Access Allows the account to execute CGI scripts.
Digest Authentication at account creation Enables Digest Authentication support for Web Disk access over a clear text or unencrypted connection. Users with Microsoft® Windows Vista®, Windows® 7 , and Windows® 8 operating systems require this support.
This setting is required if your server does not have an SSL certificate that a recognized certificate authority has signed.
cPanel Theme Select a theme from the menu.
Feature List Select a feature list from the menu. Feature lists define which cPanel features your users can access. To view or edit the currently-selected feature, click View to navigate to WHM’s Feature Manager interface (WHM >> Home >> Packages >> Feature Manager).
The disabled feature list is not intended for use with a cPanel account or a package. Instead, assign a cPanel account or package the default feature list, but define the feature you do not want available on the server in the disabled feature list.
Locale Select a locale from the menu.

Package Extensions

You cannot add or remove package extensions from an existing package through WHM. You may either add a package or use API calls to modify package extension data if you wish to use a different set of package extensions.

If package extensions are installed on your server, the Package Extensions section appears at the bottom of this interface. If you wish to include a package extension in a package, select the checkbox next to the extension name.

Some extensions may include variables that you can change.

  • Options or settings that you can edit appear below the extension name. The package will include only the addons that you select and that the interface displays at the time you submit the form.

  • cPanel & WHM retrieves the settings that you can edit from the extension’s default settings.

  • To find out more about extension options and how to change them, consult the third-party software’s documentation.

For more information about package extensions, read our Package Extensions documentation.

Additional Documentation