How to change the username of a hosting account
You can rename an account, for example when the username was generated by a billing system and the customer wants a better one. The customer then signs in with the new username.
Before you start
- Resellers need the Modify accounts (package, contact email, domain, username) privilege.
- The new username must follow the same rule as a new account: 2–16 characters, lowercase letters and digits, starting with a letter, and not taken.
Steps
- Open List Accounts (section Accounts) in the admin panel and click Manage next to the account.
- Under Modify account, click Change the main domain or the username.
- Replace the username in the second field.
- Click Rename and confirm.
You see Account renamed. It is ready within a minute.
What happens
- The system user and its home folder are renamed:
/home/oldbecomes/home/new. A link is left at the old path, so paths written inside websites keep working. - Cron jobs that used
/home/old/are updated, and everything the panel runs for the account follows. - Websites, email and applications stop for a few seconds.
- Databases and database users keep their names, so website configuration files do not need changes.
- The customer signs in to the control panel, FTP and SFTP with the new username. The password stays the same.
Good to know
- If a task for the account is still running, you see The account has tasks still running. Try again in a minute.
- Webhooks send
account.changedwithold_username. - A billing system can rename through
/json-api/modifyacctwithnewuser. Update the username in the billing system too, or it will not find the account any more.
Common questions
Why do I get "That username is already taken."?
Another account, a reseller or a system user on the server already has that name. Choose another one.
Thank you — this helps us improve the article.
Still stuck?
Ask the AI about your exact situation — it answers from this knowledge base — or contact us.
Related articles
- How to change the main domain of a hosting account
Change a hosting account's primary domain. Subdomains, DNS zone, email addresses, forwarders and logins follow the new name and certificates are issued again.
- How to change a hosting account's password
Set a new password for a hosting account from the admin panel, or change your own control panel password. Password rules and what else the password is used for.
- How to create a hosting account (new customer)
Create a hosting account in the admin panel: domain, username, password, contact email and package, what the server sets up and the rules of each field.