In WHM\/cPanel, each hosting account is assigned a package that defines its resource limits (such as disk space, bandwidth, number of domains, etc.).
There are cases where you may need to change the package of an existing account (e.g., upgrading from a starter plan to a higher plan).<\/p>\n\n\n\n
This document outlines the procedure to switch a cPanel account to a different package using the WHM API<\/strong> and verify the changes.<\/p>\n\n\n\n Before proceeding, ensure the following:<\/p>\n\n\n\n Use the following command to change the package of the user:<\/p>\n\n\n\n If successful, you should see a JSON output indicating the package update.<\/p>\n\n\n\n Run the following command to confirm that the package was updated:<\/p>\n\n\n\n Expected output (example):<\/p>\n\n\n\n This confirms that the user is now assigned to the By using the WHM API ( This method is especially useful for administrators who manage multiple accounts and want to automate package changes via scripts or provisioning workflows.<\/p>\n","protected":false},"excerpt":{"rendered":" Introduction In WHM\/cPanel, each hosting account is assigned a package that defines its resource limits (such as disk space, bandwidth, number of domains, etc.).There are cases where you may need to change the package of an existing account (e.g., upgrading from a starter plan to a higher plan). This document outlines the procedure to switch ..<\/p>\nPrerequisites<\/h2>\n\n\n\n
\n
You must have SSH access to the WHM server with root privileges.<\/li>\n\n\n\n
The server should have WHM API (whmapi1<\/code>) installed and accessible. This is usually available by default on cPanel\/WHM servers.<\/li>\n\n\n\n
The package you want to assign (e.g., L-Starter<\/code>) must already be created in WHM under Packages \u2192 <\/strong>Add a Package.<\/li>\n\n\n\n
You must know the exact cPanel account username to be updated.<\/li>\n<\/ol>\n\n\n\nSteps to Change the Package<\/h2>\n\n\n\n
Step 1: Run the WHM API command<\/h3>\n\n\n\n
$ whmapi1 --output=jsonpretty changepackage user='<username>' pkg='L-Starter'<\/span><\/code><\/pre>\n\n\n\n\n
<username><\/code> with the actual cPanel username.<\/li>\n\n\n\nL-Starter<\/code> with the desired package name.<\/li>\n\n\n\n--output=jsonpretty<\/code> option displays the response in a structured format for better readability.<\/li>\n<\/ul>\n\n\n\nStep 2: Verify the Package Assignment<\/h3>\n\n\n\n
$ grep ^PLAN \/var\/cpanel\/users\/<username>\n<\/code><\/pre>\n\n\n\nPLAN=L-Starter\n<\/code><\/pre>\n\n\n\nL-Starter<\/code> package.<\/p>\n\n\n\nConclusion<\/h2>\n\n\n\n
whmapi1<\/code>) command, you can efficiently change the package of any cPanel account without manually navigating through the WHM interface.
Verification via the \/var\/cpanel\/users\/<username><\/code> file ensures that the changes have been applied correctly.<\/p>\n\n\n\n