How to Upgrade or Downgrade a cPanel Account Using WHM: SysAdmin Guide (2026)

As a web hosting reseller, agency administrator, or server owner managing client websites in WebHost Manager (WHM), one of the most routine operational tasks you will perform is modifying client account resource allocations.

A client’s business may be expanding, requiring an upgrade from a “Starter 5GB” plan to an “Enterprise 50GB” tier to accommodate high-resolution product photos and database growth. Conversely, a client downsizing their email accounts may request a package downgrade to lower their monthly hosting costs.

Fortunately, WHM makes scaling cPanel resources seamless. You do not need to migrate files, change IP addresses, or experience a single second of website downtime.

In this concise, step-by-step 2026 administrator tutorial, we guide you through the exact process of upgrading and downgrading cPanel accounts in WHM, demonstrate how to modify custom quotas on the fly, and explain how to prevent common quota recalculation bugs.

---

1. Understanding How WHM Packages Work

In WHM, a Package is a reusable blueprint or template that defines a standardized set of resource limits:

• Disk Quota: Maximum storage allowed in megabytes (e.g., 5120 for 5GB) or unlimited.
• Monthly Bandwidth: Data transfer allowance per billing cycle.
• Max Email Accounts & Databases: Cap on email inboxes, MySQL databases, and subdomains.
• cPanel Theme & Feature List: Dictates which tools and icons appear inside the user’s cPanel interface.

When you upgrade or downgrade an account, WHM simply updates the account’s configuration pointers to reference the new package specifications and immediately applies the new filesystem quotas.

WHM Reseller / Root Admin
            │
            ▼
Select cPanel User: "clientstore"
            │
            ▼
Current Package: "Starter-5GB"  ──►  New Package: "Pro-25GB"
            │
            ▼
WHM automatically adjusts:
  • Linux Filesystem Quota (5GB -> 25GB)
  • Bandwidth Allotment (50GB -> 250GB)
  • Database & Email Limits
✅ Result: Zero Downtime, Zero Re-IP, Instant Upgrade!

---

2. Step-by-Step: Upgrading or Downgrading an Account

Follow these steps in WHM to modify an account’s package:

Step 1: Access the “Upgrade/Downgrade an Account” Tool

1. Log into your WHM Control Panel (https://your-server-ip:2087).
2. In the top-left navigation search box, type “Upgrade”.
3. Under the Account Functions section, click Upgrade/Downgrade an Account.

Step 2: Select the Target cPanel Account

You will see a list of all active cPanel accounts on your server.

1. Scroll through the list or use the search box to find the domain or username (e.g., clientstore).
2. Click the radio button next to the account name.
3. Click the blue Modify button at the bottom of the screen.

Step 3: Choose the New Package

WHM will display the account’s current package alongside all available packages configured on your reseller or root account.

1. Select the new target package (e.g., choose Business-Pro instead of Starter-Basic).
2. Click Upgrade/Downgrade.

WHM will instantly apply the package template. A confirmation screen will display the new quota parameters and confirm that the account was modified successfully.

---

3. Alternative: Manually Modifying Individual Quotas Without Changing Packages

Sometimes a client needs extra disk space or additional email inboxes, but you do not want to switch their entire package template. You can adjust individual quotas directly:

1. In WHM, navigate to Account Functions -> Modify an Account.
2. Select the client account and click Modify.
3. Under Resource Limits, manually adjust the specific field:
   • Increase Disk Space Quota (MB) (e.g., change 5000 to 8000).
   • Increase Monthly Bandwidth Limit (MB).
   • Adjust Max Email Accounts or Max FTP Accounts.
4. Scroll to the bottom and click Save.

(Note: If you later apply a package upgrade, WHM will overwrite these manual custom values with the package’s default specifications).

---

4. Troubleshooting & Best Practices

Issue 1: “The account exceeds the quota of the new package”

When attempting to downgrade an account, WHM will reject the operation if the client is currently using more disk space than the lower package permits.

• Solution: Instruct the client to purge old email trash folders, delete unused staging sites or zip backups from /home/username/, or optimize their MySQL database before processing the downgrade.

Issue 2: cPanel Displays Inaccurate Disk Usage After Upgrade

Occasionally, the cPanel end-user interface continues displaying the old disk quota bar due to cached filesystem blocks.

• Solution via SSH: Run the cPanel quota recalculation script:

  /scripts/fixquotas
  /scripts/generate_storage_logs

---

5. Enterprise Infrastructure: Scaling Beyond Single-Server Limits

While WHM package modifications allow agile vertical resource scaling, when an e-commerce or agency client reaches enterprise traffic levels, single-node shared hosting environments introduce performance ceilings.

To deliver uncompromising reliability and dedicated performance:

• Isolated Virtual Compute: Migrate fast-growing client accounts to high-performance Cloud VPS in Pakistan equipped with high-IOPS NVMe storage and dedicated vCPU allocations.
• Enterprise Multi-Tenant Bare-Metal: High-volume agencies managing hundreds of client cPanels require the massive physical RAM capacity (up to 512GB) and unshared CPU cores of bare-metal Dedicated Servers.
• Sub-15ms Domestic Routing: For agency clients based in Karachi, Lahore, and Islamabad, hosting on Dedicated Servers in Pakistan delivers sub-15ms domestic ping times over direct local PKIX exchanges, providing clients with blistering website performance that commands premium agency retainer pricing.

---