{"id":3942,"date":"2026-07-22T12:43:45","date_gmt":"2026-07-22T12:43:45","guid":{"rendered":"https:\/\/pheonixsolutions.com\/knowledge-base\/?p=3942"},"modified":"2026-07-22T12:43:58","modified_gmt":"2026-07-22T12:43:58","slug":"how-to-change-a-cpanel-username-via-the-command-line-cli","status":"publish","type":"post","link":"https:\/\/pheonixsolutions.com\/knowledge-base\/2026\/07\/22\/how-to-change-a-cpanel-username-via-the-command-line-cli\/","title":{"rendered":"How to Change a cPanel Username via the Command Line (CLI)"},"content":{"rendered":"\n
Introduction<\/h2>\n\n\n\n
Changing a cPanel username is useful when you need to standardize account names, resolve naming conflicts, or update an account to follow your organization’s naming conventions. cPanel provides the WHM API (modifyacct<\/code>)<\/strong> command, which allows administrators to safely rename an existing cPanel account from the command line.<\/p>\n\n\n\n
When a cPanel username is changed, the associated system user, home directory, and account configuration are updated automatically. However, you should verify your websites, email accounts, cron jobs, and any applications that reference the old username after the rename.<\/p>\n\n\n\n
Prerequisites<\/h2>\n\n\n\n
Before proceeding, ensure that:<\/p>\n\n\n\n
\n
You have root SSH access<\/strong> to the server.<\/li>\n\n\n\n
A full backup<\/strong> of the cPanel account has been created.<\/li>\n\n\n\n
The new username:\n
\n
Contains only lowercase letters and numbers.<\/li>\n\n\n\n
Does not exceed 16 characters<\/strong>.<\/li>\n\n\n\n
Does not already exist on the server.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
IMPLEMENTATION<\/h2>\n\n\n\n
Step 1: Verify the Existing Account<\/strong><\/p>\n\n\n\n
Before renaming the account, verify that the current cPanel account exists.<\/p>\n\n\n\n
Renaming a cPanel username using the WHM API<\/strong> is a straightforward process that can be completed with the modifyacct<\/code> command. Before making the change, ensure you have a recent backup and verify that the new username meets cPanel’s naming requirements. After the rename, confirm that the account, websites, email services, databases, and scheduled tasks are functioning correctly. Performing these verification steps helps ensure a smooth transition with minimal service interruption.<\/p>\n","protected":false},"excerpt":{"rendered":"
Introduction Changing a cPanel username is useful when you need to standardize account names, resolve naming conflicts, or update an account to follow your organization’s naming conventions. cPanel provides the WHM API (modifyacct) command, which allows administrators to safely rename an existing cPanel account from the command line. When a cPanel username is changed, the ..<\/p>\n
![\"\"](\"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-content\/uploads\/2026\/07\/image-4.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-content\/uploads\/2026\/07\/image-5-1024x217.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/pheonixsolutions.com\/knowledge-base\/wp-content\/uploads\/2026\/07\/image-6.png\")
<\/figure>\n\n\n\n