How to change the username of a hosting account

For server administrators · Updated 2026-10-29

On this page
  1. Before you start
  2. Steps
  3. What happens
  4. Good to know
  5. Common questions

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

  1. Open List Accounts (section Accounts) in the admin panel and click Manage next to the account.
  2. Under Modify account, click Change the main domain or the username.
  3. Replace the username in the second field.
  4. 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/old becomes /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.changed with old_username.
  • A billing system can rename through /json-api/modifyacct with newuser. 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.

Was this article helpful?

Still stuck?

Ask the AI about your exact situation — it answers from this knowledge base — or contact us.