Domains
Valid for versions 110 through the latest version
Version:
110
Last modified: October 21, 2024
Looking for this interface?
Your hosting provider can enable or disable this interface in WHM's Feature Manager interface (WHM >> Home >> Packages >> Feature Manager).
Overview
Use this interface to create and manage multiple domains from a single cPanel account.
- You can change your primary domain via WHM’s Modify an Account interface (WHM » Home » Modify an Account).
- Some settings only appear if your hosting provider’s settings enable them.
Actions
Create a New Domain
To create a new domain, your hosting provider must enable at least one the following features in WHM’s Feature Manager interface (WHM » Home » Packages » Feature Manager):
To create a domain, perform the following steps:
- Click Create a New Domain. A new interface will appear.
- Enter a fully qualified domain name (FQDN) in the Domain text box.
- To create a new domain, enter the new domain name. For example,
example.com
. - To create a subdomain, enter a new name followed by a period (
.
) and then the website’s domain. For example, entersubdomain.example.com
to create a subdomain ofexample.com
.
- To create a new domain, enter the new domain name. For example,
- Optionally, you can specify the directory where you want the files for the domain to exist (the domain’s document root. To create this directory, deselect the Share document root with “example.com” checkbox, where
example.com
represents your main domain. You cannot create a document root outside of thepublic_html/
directory. This will create an addon domain. You cannot use the following directories:Click to view...- 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
Note:- This setting only appears if your hosting provider enables it.
- 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.
- The account’s home directory itself (
- Click Submit or click Submit and Create Another.
Visitors cannot view your subdomain immediately. Changes to DNS records may require two days or more to reach each nameserver on the internet.
Certificates
When you create a domain or subdomain, the system will attempt to secure that domain with an existing certificate.
- If no certificate exists, the system will generate a self-signed certificate to secure the new domain.
- If your hosting provider enables AutoSSL for the account that owns the new domain, the system will add a request for an AutoSSL certificate to secure the new domain and install it when it becomes available.
Force HTTPS Redirect
Use the Force HTTPS Redirect toggle to automatically redirect a domain’s visitors from the insecure version of the website to the secure version.
To automatically redirect visitors for a single domain, set the Force HTTPS Redirect toggle on for the domain.
To automatically redirect visitors for multiple domains, select the checkbox for each domain. Then, select Enable Force HTTPS Redirect.
Manage the Domain
Use the Manage the Domain interface to manage the domain’s document root directory, remove the domain, or perform other actions. From the Additional Resources menu, you can select the following actions to perform in a new browser tab:
Action | Description |
---|---|
Create an Email Address | Add an email address to the website. |
Create a Site with Sitejet Builder | Quickly create a simple website, even if you have never created a website before. |
Modify the Zones | Create, edit, and delete Domain Name System (DNS) records. |
Modify the Redirects | Send all of the visitors of a domain or particular page to a different URL. |
New document root
The domain’s document root directory defines the domain’s directory relative to the cPanel account’s home directory. For example, enter newdomain.com
in the New Document Root text box for a cPanel account that uses the /home/username
home directory. That domain’s files will reside in the /home/username/public_html/newdomain.com
directory.
- This action changes the directory where the server searches for your files. It does not rearrange your files in any way.
- You cannot change the document root directory for the main domain.
- You cannot modify the document root directory for domains that share that directory with the main domain.
To provide a new document root directory, perform the following steps:
- Enter a new path, relative to the user’s home directory.
- Click Update.
Remove the domain
- 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.
To remove the domain from the cPanel account, perform the following steps:
- Click Remove Domain.
- To confirm that you wish to remove this domain, click Yes, remove this 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.
List Domains
This interface lists your domains.
Item | Actions |
---|---|
Domain |
|
Document Root |
|
Redirects To | If the listed domain redirects to a different domain, the destination will appear here. Click a domain to visit the public-facing website. A new tab will appear. To manage redirects, navigate to the Redirects interface (cPanel » Home » Domains » Redirects). |
Force HTTPS Redirect |
Important:
|
Actions |
|
Show Associated Subdomains | To show subdomains that the system automatically creates, perform the following steps:
|