Changing the username of a cPanel account
has certain consequences. This article covers what you’ll need to keep in mind after requesting this change within our
Shared Hosting servers.
As an example, we will reference screenshots of a cPanel account with the following setup:
In this case, the username of the cPanel account is changed from cpuser1 to cpuser2. The post-change changes to your setup are as follows:
- Existing cPanel username: cpuser1
- New cPanel username: cpuser2
- MySQL Databases (and their privileged MySQL User): cpuser1_db1 (cpuser1_dbuser1), cpuser1_db2 (cpuser1_dbuser2), cpuser1_db3 (cpuser1_dbuser3)
- PostgreSQL Databases (and their privileged PostgreSQL User): cpuser1_pdb1 (cpuser1_pdbuser1), cpuser1_pdb2 (cpuser1_pdbuser2), cpuser1_pdb3 (cpuser1_pdbuser3)
- Primary (default) cPanel Email Account: email@example.com
- Primary (default) cPanel FTP Account username: cpuser1
- Primary (default) cPanel Web Disk Account: cpuser1
1. Home Directory
2. MySQL databases and MySQL users
3. PostgreSQL databases and PostgreSQL users
4. Website configuration scripts
5. Primary (default) cPanel FTP account
6. Primary (default) cPanel Email account
7. Primary (default) cPanel Web Disk account
Changing the username of a cPanel account affects the path to the Home Directory. This is important because some scripts rely on absolute paths (those starting from the root, “/”) e.g. /home/cpuser1/public_html/.
But if your website script incorporates paths related to the current working directory (called relative paths), you won’t need to make any changes.
All MySQL databases and database usernames created in cPanel are associated with the cPanel username. They are formatted as: cPanelUsername_DatabaseName
for databases (e.g. cpuser1_db1
), or cPanelUsername_DatabaseUser
) for database users.
When the cPanel username is changed, the database names and usernames are updated automatically too. However, the update is applied within the server configuration files only. That means if you have an active connection set up on one of the hosted MySQL databases (e.g.,
MySQL client), the connection and its settings need to be changed. Otherwise, MySQL client software may not work as expected.
We suggest keeping the new cPanel username the same length or shorter. A longer name may cause MySQL service to truncate the account’s database names and database usernames, which may cause unexpected problems in the future.
Similar to MySQL databases, PostgreSQL databases have similar layouts for their database names and users: cPanelUsername_DatabaseName and cPanelUsername_DatabaseUser. So you’ll also need to change the connections to the PostgreSQL server.
PostgreSQL users may not be able to log in until their passwords are reset using the cPanel PostgreSQL Databases >> Current Users >> Change Password menu. The Grants will also need to be synchronized after the cPanel username change is applied:
4. Website configuration scripts
Because of changes to the naming of the Home Directory and database access credentials (as mentioned in sections 1 to 3), certain website scripts may stop working as expected and display random error messages.
Please note that the cPanel username is changed on the hosting server only. Website-specific files and directories remain unaffected.
If your website depends on the MySQL-based databases or other connections, configuration files will need to be updated to align with the applied cPanel username change. For instance, a website based on the WordPress Content Management System (CMS) will keep displaying the
“Error Establishing A Database Connection”
message unless its wp-config.php
file is edited to match the new cPanel configuration.NOTE
: Each CMS has its own location for configuration files. The following list of popular CMS platforms provides their locations. Ensure the configuration files match the database connection setup. If the CMS or framework of your website is not listed below, contact your site platform provider or refer to the software specifications.
|Content Management System (CMS)||Default location of the configuration file|
|OpenCart||/admin/config.php and /config.php|
cPanel username always matches the primary FTP account of the hosting account. The latter provides access to the whole file system of cPanel. We strongly recommend using it, along with the
SFTP (SSH-based secure FTP, encrypted)
type of connection.
However, the change of the cPanel username will require updating the settings of FTP clients, such as
The default cPanel email account (cPanelUsername@server.hostname
) catches all unrouted email. It cannot be deleted and has no quota. Its username and password will always be the same as your cPanel account’s login.
If there are any outgoing email scripts set up using the
PHP mail() function
, or no custom email address set up has been specified for
, you may receive notifications to firstname.lastname@example.org
after the cPanel username is changed from cpuser1
The purpose of the
Web Disk utility
and its accounts is to manage and manipulate files within the Home Directory of your hosting account, on multiple types of devices (such as your computer, mobile device, or certain types of software).
This interface allows you to manage the file system using the Web Distributed Authoring and Versioning (WebDAV) protocol. The username of the main Web Disk account always corresponds to that of the cPanel account.
This WebDisk account can access all of the files in your Home Directory. So if you use WebDav protocol to manage the files of the hosting account through the main Web Disk account, make sure to
update the connection’s configuration
after the cPanel username is changed.