How to Convert an Addon Domain to an Independent cPanel Account Using WHM (2026)

When starting out with a single cPanel hosting account, adding secondary websites as Addon Domains is a fast and convenient way to host multiple projects under one roof. All domains share the same disk space, bandwidth allotment, and root login credentials.

However, as an addon website grows into a thriving business, a dedicated e-commerce store, or is sold to a new client, sharing a single cPanel account introduces major security and operational hazards:

• The addon domain shares the same Linux user permissions; if one site is compromised by malware, all other sites under that cPanel account are vulnerable.
• Resource limits (CPU, RAM, I/O) are shared, causing traffic spikes on one domain to throttle the others.
• You cannot grant the client their own private cPanel login without exposing your entire file structure and email accounts.

Fortunately, cPanel & WHM includes a dedicated, automated native utility: the Convert Addon Domain to Account tool.

In this step-by-step 2026 administrator guide, we walk you through the complete conversion process, explain how MySQL databases and email accounts are cleanly transferred, and reveal post-migration DNS checks to guarantee zero downtime.

---

1. Prerequisites Before Beginning the Conversion

Before executing the conversion in WebHost Manager (WHM), verify the following checklist:

1. Root or Reseller Privileges: You must have root SSH/WHM access or a reseller account with the “Create Accounts” and “Edit Account” ACL permissions.
2. Available Account Quota: Ensure your reseller plan has at least one unused cPanel account allocation and sufficient unassigned disk space.
3. Full Account Backup: Always take a full backup of the parent cPanel account before initiating structural splits:

   /scripts/pkgacct parentusername /home/backups/

4. Identify Associated Resources: Note the exact document root folder (e.g., /public_html/addondomain.com/), MySQL database names, and email accounts associated with the addon domain.

---

2. Step-by-Step Walkthrough in WHM

WHM Dashboard -> Transfers / Account Functions
                      │
                      ▼
   "Convert Addon Domain to Account"
                      │
                      ▼
   Select Parent Account & Addon Domain
                      │
                      ▼
   Configure New User, Package & Database Ownership
                      │
                      ▼
   Execute Conversion -> Background Process Complete!

Step 1: Open the Conversion Tool in WHM

1. Log in to your WHM Control Panel (usually https://your-server-ip:2087).
2. In the top-left search bar, search for “Convert Addon Domain”.
3. Under the Transfers section, click Convert Addon Domain to Account.

Step 2: Select the Addon Domain

You will see a list of all cPanel accounts hosting addon domains on the server.

1. Locate the parent cPanel account.
2. Find the specific addon domain you wish to separate.
3. Click the Convert button next to the domain name.

Step 3: Configure the New Standalone Account Details

WHM will launch a configuration wizard where you define the parameters for the new independent cPanel account:

Configuration Field	Recommended Setting	Technical Explanation
New Username	e.g., newsite (Max 16 chars)	Unique Linux username for the new account
Contact Email	[email protected]	Receives quota warnings and SSL notifications
Package	Select an existing WHM package	Defines disk quota, bandwidth, and email limits
Dedicated IP	Shared or Dedicated	Assign a dedicated IP if the site requires custom SSL routing

Step 4: Map Databases, Database Users, and Email Accounts

WHM intelligently scans the parent account and highlights resources mapped to the addon domain:

• MySQL Databases: Check the boxes next to the databases that belong to the addon domain. WHM will automatically update the database prefix to match the new username.
• Email Accounts: Select the email inboxes created under @addondomain.com. WHM will migrate all maildir messages, folders, and forwarders without message loss.

Step 5: Start the Conversion Process

Click Start Conversion.

WHM will dispatch a background queue worker to:

1. Create the new Linux system user and home directory (/home/newsite/).
2. Move files from the old document root into the new account’s /home/newsite/public_html/.
3. Export and re-import selected MySQL databases under the new user prefix.
4. Move email storage directories and update Exim mail routing.
5. Update Apache/LiteSpeed virtual host templates and DNS zone files.

---

3. Post-Conversion Verification & Configuration Fixes

Once the conversion completes, perform these essential validation checks:

1. Update Database Connection Strings (wp-config.php / .env)

Because WHM modifies the database user prefix to match the new cPanel username (e.g., from parent_db to newsite_db), you must update your CMS configuration file:

Open /home/newsite/public_html/wp-config.php:

// Update with the new database name and user credentials
define( 'DB_NAME', 'newsite_wpdb' );
define( 'DB_USER', 'newsite_dbuser' );
define( 'DB_PASSWORD', 'YourSecurePasswordHere' );
define( 'DB_HOST', 'localhost' );

2. Verify File Permissions

Ensure that ownership of the migrated files belongs entirely to the new Linux user:

chown -R newsite:newsite /home/newsite/public_html/
find /home/newsite/public_html/ -type d -exec chmod 755 {} \;
find /home/newsite/public_html/ -type f -exec chmod 644 {} \;

3. Check SSL/TLS Certificates

Run the AutoSSL check in WHM to ensure the newly separated domain receives an independent Let’s Encrypt / Sectigo certificate:

/usr/local/cpanel/bin/checkallsslcerts --verbose --user=newsite

---

4. Enterprise Infrastructure: Scaling Beyond Single-Server WHM

While WHM makes account partitioning seamless on a single server, high-traffic client websites and agency platforms will eventually outgrow shared VPS environments.

When client performance and reliability become paramount:

• Isolated Virtual Environments: Deploy client accounts across high-performance Cloud VPS in Pakistan equipped with high-IOPS NVMe storage and dedicated vCPU cores.
• 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.

---