Child pages
  • Domains
For cPanel & WHM version 76

Skip to end of metadata
Go to start of metadata

(cPanel >> Home >> Domains >> Domains)

Overview 

Use this interface to create and manage multiple domains from a single cPanel account.

Create a New Domain

Use the Create a New Domain interface to add a domain to your account.

Note:

To use this feature, your hosting provider must allow domain creation in WHM's Modify an Account interface (WHM >> Home >> Account Functions >> Modify an Account).

To create a domain, perform the following steps:

  1. Click Create a New Domain. A new interface will appear.
  2. Enter a fully qualified domain name in the Domain text box.
    1. To create a new domain, enter the new domain name. For example, example.com.
    2. To create a subdomain, enter a new name followed by a period ( . ) then the website's domain. For example, enter blog.example.com to create a subdomain of example.com.
  3. Optionally, you can specify the directory where you want the files for the domain to exist (document root). To create a new document root, deselect the Share document root with "example.com", where example.com represents your main domain.

    Notes:

    • The interface automatically populates the remaining text boxes, and we recommend that you use these values. However, you can enter different values in the Document Root (File System Location) and Subdomain text boxes if you desire.
    • This option only appears if your hosting provider enables it.
    • You cannot use the following directories as a document root:
       Click here to expand...
      • The account's home directory itself ( / )
      • Directories outside of the account's home directory ( ./ and ../ )
      • .cpanel
      • .trash
      • etc
      • mail
      • ssl
      • tmp
      • logs
      • .cphorde
      • .spamassassin
      • .htpasswds
      • var
      • cgi-bin
      • .ssh
      • perl5
  4. Click Submit or click Submit and Create Another Domain.

In This Document

Related Documentation

For Hosting Providers

List Domains

This interface lists your domains.

ColumnDescription
Domain
  • Click Domain to sort the list alphabetically by account name.
  • Click an individual domain to visit the public-facing website.

Note:

The Main Domain label identifies the domain that your hosting provider listed to create this account.

Document Root
  • Click Document Root to sort the list alphabetically by relative root path.
  • Click the home icon () or the file path to navigate to the File Manager interface (cPanel >> Home >> Files >> File Manager) for that domain. A new interface will appear.

Note:

This interface displays an unlinked file path if your hosting provider disables the File Manager feature. For more information, contact your hosting provider.

Redirects To
  • If the listed domain redirects to a different domain, the destination will be listed here. Click a domain to visit the public-facing website. A new tab will appear.

Note:

To manage redirects, navigate to the Redirects interface (cPanel >> Home >> Domains >> Redirects).

Actions
  • Manage — To manage additional options, click Manage. A new interface will appear.
  • Create Email — To create email addresses for the domain, click Create Email. The Email Accounts interface (cPanel >> Home >> Email >> Email Accounts) will appear.
Show Associated Subdomains

To show subdomains that the system automatically creates, perform the following steps:

  1. Click the gear icon ().
  2. Click Show Associated Domains.

Manage

Use the Manage the Domain interface to manage the document root path, remove the domain, or perform other actions.

In the Additional Resources menu, you can perform the following actions (a new tab will appear):

Note:

These options only appear if your hosting provider enables them.

New document root

The document root defines the domain's directory relative to the cPanel account's home directory. For example, if you enter newdomain.com in the New Document Root text box and the cPanel account uses the /home/username home directory, the files for that domain will exist in the /home/username/public_html/newdomain.com/ directory.

Notes:

  • This option only appears if your hosting provider enables it.
  • This action changes the directory where the web server searches for your files. It does not rearrange your files in any way.
  • You cannot modify the document root for domains that share the document root with the main domain.

To provide a new document root, perform the following steps:

  1. Enter a new document root path relative to the user's home directory.
  2. Click Update.

Remove the domain

To remove the domain from the cPanel account, perform the following steps:

  1. Click Remove Domain.
  2. To confirm that you wish to remove this domain, click Yes, remove this domain.

Notes:

  • We strongly recommend that you create a full account backup before you remove a domain. For more information about backups, read our Backup documentation.
  • This action only removes the domain's vhost entries and DNS entries. The server retains the domain's directory and contents.
  • You cannot delete the main domain.
Email accounts when you remove a domain

If you remove a domain that contains email accounts, those email accounts will not appear in the Email Accounts interface (cPanel >> Home >> Email >> Email Accounts). However, the mail folders continue to exist on the server. If you add the domain again, the email accounts will reappear.