Skip to content

Managing domains on a cPanel account

Every cPanel account has one main domain, set when the account was created. On the account's Domains screen you add anything else you host on it, such as a second website, a second name for the same site or a subdomain. You also choose whether a domain receives its email on the account, and which folder it serves its files from.

Before you start

  • cPanel Accounts must be in your workspace sidebar. If it isn't, see cPanel hosting: overview.
  • Adding, removing and changing domains, turning email on or off, and changing email routing need permission to manage billing for the workspace that owns the account. Other members can look but not change.
  • You can register a name that isn't registered yet while adding it. See Purchasing a domain.
  • Suspended and pending-deletion accounts can't have domains managed. See Deleting and recovering an account.

Open the Domains screen

  1. Open the account list. In the workspace sidebar, choose cPanel Accounts.

  2. Choose Manage Domains. Open the actions menu on the account's row and choose Manage Domains.

The screen lists every domain on the account with its type (Main, Addon, Alias or Subdomain), its document root and its connection status (a mail-only MailXXL account's list has neither, and its domains have no page of their own). Counters at the top show how many Addon domains, Aliases and Subdomains are in use out of what your package allows. A kind that has reached its limit is marked Full.

If the account has no domain of its own yet

A new account can start on a temporary address. The Domains screen then shows This account has no domain of its own yet, and the temporary address in the list carries a Temporary badge. Create a New Domain is hidden until you choose Set main domain and enter the domain the account should use. You can add other domains after that. If the account already has other domains, remove them first; the main domain can only be set while there are none.

Which kind of domain to add

You type a name and the dashboard works out which kind it is, asking at most one question.

Kind What it is
Addon A second, separate website on the same account, with its own folder
Alias Another name for your main website. It shows the main domain's content
Subdomain An extra label in front of a domain already on the account, such as blog., with its own folder

Add a domain

Adding an addon or alias domain takes two screens: you name the domain, then choose how it reaches the account. A subdomain of a domain already on the account skips the second screen.

  1. Choose Create a New Domain. The button is in the header of the Domains screen.

  2. Type the name. In the Domain field, type the whole name, such as shop.example.com.

  3. Answer the question, if you're asked. For a new domain, What should it show? offers Its own separate site (an addon domain) or Same as an existing site (an alias). A subdomain of a domain already on the account needs no answer.

  4. Optional: set a document root. Under Advanced, Document root (optional) defaults to a new folder under public_html.

  5. Choose Add domain. For a subdomain, that's all: the domain is added and you land on its page. For an addon or alias, the Connect screen opens. Nothing is added until you finish it.

  6. Follow what the Connect screen shows. It depends on where the name is registered and who hosts its DNS:

    • We host the DNS, or it stays on its current nameservers. The screen lists what will be written, or says there's nothing for you to change. No change at your registrar is needed. If a record already in the way would be replaced, the screen says so; you approve that with Replace & add in step 8.
    • The DNS is elsewhere. Under How do you want to connect it?, choose Use our nameservers (we manage the DNS; you change the nameservers at your registrar) or Point an A record (you keep your DNS and add the records shown at your DNS provider). Only the A record option is offered for a name under another domain, a name registered to another CloudPress customer, or a name whose DNS lives in another workspace.
    • The name is available, or registered elsewhere. Register it first, or transfer it to CloudPress, or keep it where it is and connect it. Where offered, Register and add adds it to the account once the registration completes; otherwise choose Register domain and come back to add it afterwards. A premium name goes through support. See Purchasing a domain.
  7. Choose whether to receive email here. Where it's offered, Also receive email for this domain on this cPanel account adds the mail records. Leave it off if the domain's email is hosted elsewhere. It isn't offered for a name under another domain, for a domain whose email is handled by Mailspace, or when the domain's DNS stays on its current nameservers.

  8. Choose Add domain (or Replace & add). You land on the domain's own page (on a mail-only account, back on the list), which shows Setup progress (Added, Setting up DNS records, Pointing DNS, Live) and updates by itself, so you can leave it. DNS changes can take a few hours to reach everyone. If the domain isn't pointing at the account yet, the page shows the nameservers or records to set. Choose Check again after you change them.

On the Domains screen, the Status column shows Connected, Waiting for nameservers, Points elsewhere or Unknown. A domain with DNS records waiting for your approval says so under its name; open it and choose Replace & connect.

When CloudPress hosts the domain's DNS, its records are in a zone you can view and edit under Domains in the workspace sidebar. See Managing DNS.

Turn email on or off for a domain

Each domain's page has an Email on this cPanel account switch, shown as On or Off. It's only on the domain's own name, and not while the domain is still being set up. If CloudPress doesn't host the domain's DNS and it isn't connected yet, the switch adds the mail record to the records you set at your DNS provider.

  1. Open the domain. On the Domains screen, choose the domain's name.

  2. Choose Turn on email or Turn off email. On, the DNS sends the domain's email to this account. Off, CloudPress removes the mail records it added; records you added yourself stay. Turn it on to receive the domain's email here.

If the domain's email is handled by Mailspace, the switch isn't offered, because that email can't also be received on the cPanel account.

Which server accepts the email is a separate setting, Email routing: Automatic, Local, Backup or Remote. Under the switch, choose Change next to Email routing. Or open Email routing in the account's actions menu on the cPanel Accounts list, choose Change next to the domain, pick a setting and choose Save. The page warns you when the two disagree, for example when email is on but routing is Remote, so the mailboxes on the account receive nothing. MX records are managed in DNS, not on the routing screen.

Change a document root

The document root is the folder a domain serves its files from. You can change it for an addon domain or a subdomain, not for the main domain or an alias.

  1. Choose the pencil. On the Domains screen, choose the edit icon (Change document root) next to the domain's document root.

  2. Enter the folder. In New document root, type a folder inside your home directory that already exists, like public_html/shop. Create it first in the File Manager if needed. It can't be the home directory itself, a hidden folder or a system folder.

  3. Choose Change document root, and confirm your identity with your passkey or password if asked.

Your files are not moved

The change takes effect right away and the domain serves whatever is in the new folder. An empty folder means an empty site, and the SSL certificate can't renew until the site is back. Aliases on the domain follow the new folder.

When your package is full

Addon domains and aliases each have their own limit in your package. At the limit, the counter shows Full and that choice is greyed out on the add screen. To add more, move to a bigger package: see Resizing your package.

When a domain is refused

If you see This domain cannot be added to this account., the name can't be attached here, for example because it is already in use elsewhere on CloudPress. If the message says the domain is on another of your cPanel accounts, remove it there first.

  • Check the spelling.
  • If you haven't registered the name yet, see Purchasing a domain.
  • If you own the name but it lives on another workspace or was set up elsewhere, contact us.

Remove a domain

Removing a domain can't be undone

Anything served under the domain goes offline. You can add the same name again, but you start from scratch.

  1. Choose Remove on the domain's row. The main domain and the temporary address can't be removed.

  2. Confirm. Choose Confirm in the Remove domain dialog, and confirm your identity with your passkey or password if asked.

Removing a domain takes back the DNS records CloudPress added for it. The DNS zone itself and any records you added stay.

For the API, see the cPanel Accounts API reference.

Next steps