How to change the main domain of a hosting account

For server administrators · Updated 2026-10-29

On this page
  1. Before you start
  2. Steps
  3. What follows the new domain
  4. After the change
  5. Good to know
  6. Common questions

When a customer rebrands or moves to a new domain, you can give the account a new main domain. The website keeps its files and content; the names around it change.

Before you start

  • Resellers need the Modify accounts (package, contact email, domain, username) privilege.
  • The new domain must not already be hosted on the server.

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 domain in the first field, for example with new-example.com.
  4. Click Change domain and confirm.

You see Main domain changed. Certificates for the new name are issued within a few minutes.

What follows the new domain

  • Subdomains of the old domain: shop.old-example.com becomes shop.new-example.com.
  • The DNS zone, including records that pointed at the old name (for example www, mail, MX and SPF).
  • Email addresses and their mail, forwarders and the catch-all address.
  • FTP and Web Disk logins that ended with the old domain.
  • The address of WordPress sites and installed applications as listed in the panel.
  • SSL certificates are issued again for the new names.

The website folder (public_html) and its files do not move.

After the change

  • Point the new domain to the server: set its nameservers at the registrar to the server's nameservers.
  • Sites that store their own address (like WordPress) need it changed in their own settings, or they keep redirecting to the old domain.
  • Tell the customer their new email addresses.

Good to know

  • Addon domains and aliases of the account do not change.
  • Webhooks send account.changed with old_domain.
  • A billing system can change the domain through the /json-api/modifyacct function. See connect other billing systems.

Common questions

Why do I get "The domain … is already hosted on this server."?

The new name, or one of the subdomains it would create, already exists in another account or as a DNS zone. Remove it there first.

Can I instead add the new domain next to the old one?

Yes. The customer can add it as an addon domain or alias in Domains of their control panel, if the package allows it.

Was this article helpful?

Still stuck?

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