How to configure subdomains in cPanel

This article describes how to add, redirect, and delete subdomains using cPanel.

The following procedures only apply to older versions of cPanel. cPanel now includes the Domains tool, which combines functionality for subdomains, addon domains, aliases, and more. For information about how to use the Domains tool in cPanel, please see this article.

About subdomains

A subdomain is a domain that is part of a larger domain, based upon a prefix name that you choose. For example, the example.com domain might have a subdomain for the support department that directs visitors to a separate area of the web site. If the subdomain prefix is support, then the fully qualified domain name (FQDN) is support.example.com.

You can use subdomains whenever you want to create separate areas on your web site that are accessible using different FQDNs.

Adding a subdomain

To add a subdomain, follow these steps:

  1. Log in to cPanel.
    If you do not know how to log in to your cPanel account, please see this article.
  2. Open the Subdomains tool:
    • If you are using the Jupiter theme, on the Tools page, in the Domains section, click Subdomains:

      cPanel - Domains - Subdomains icon

    • If you are using the Paper Lantern theme, in the DOMAINS section of the cPanel home page, click Subdomains:

      cPanel - Domains - Subdomains icon

  3. Under Create a Subdomain, type the name of the subdomain that you want to add in the Subdomain text box.

    cPanel automatically fills in the document root path by using the subdomain name that you provide. This path is where the subdomain's files are stored. If you want to store the subdomain's files in another directory, type the full path in the Document Root text box.

    Please be aware that there are potential risks to placing website directories in subdirectories beneath an existing website. (For example, by hosting a site in the public_html directory, and a site in a subdirectory beneath the public_html directory.) Some of these risks are:

    • Websites in subdirectories can conflict with websites in the parent directories (particularly WordPress sites or sites that rely heavily on rules in .htaccess files).
    • Websites in subdirectories are more likely to be negatively affected if websites in the parent directories get hacked, or if there are malicious redirects.

    For these reasons, we recommend placing the document root for a subdomain in a dedicated directory outside of the public_html directory.

    The following names are reserved on managed accounts, so you should not use them for new subdomains:

    • cpanel
    • ftp
    • mail
    • webdisk
    • webmail
    • secure
    • www
    • whm
  4. Click Create. You can now add content to the subdomain by placing files in the subdomain's document root.

    When you create a new subdomain, the DNS records change. These changes can take up to 24 hours to fully propagate across the internet (though the process is usually much faster). For information about how to access a domain before DNS propagation is complete, please see this article.

Redirecting a subdomain

You can redirect web site visitors from a particular subdomain to another location. This feature is often used when the subdomain's web pages have moved to a new location. For example, you might redirect the sales.example.com subdomain to the salesnew.example.com subdomain.

Enabling subdomain redirection

To enable subdomain redirection, follow these steps:

  1. Log in to cPanel.
    If you do not know how to log in to your cPanel account, please see this article.
  2. Open the Subdomains tool:
    • If you are using the Jupiter theme, on the Tools page, in the Domains section, click Subdomains:

      cPanel - Domains - Subdomains icon

    • If you are using the Paper Lantern theme, in the DOMAINS section of the cPanel home page, click Subdomains:

      cPanel - Domains - Subdomains icon

  3. Under Modify a Subdomain, locate the subdomain that you want to redirect, and then click Manage Redirection.
  4. On the Redirection page, type the redirection destination address in the redirects to: text box.

  5. Click Save.
Disabling subdomain redirection

When you no longer want to redirect visitors from a subdomain to another location, disable redirection.

To disable subdomain redirection, follow these steps:

  1. Log in to cPanel.
    If you do not know how to log in to your cPanel account, please see this article.
  2. Open the Subdomains tool:
    • If you are using the Jupiter theme, on the Tools page, in the Domains section, click Subdomains:

      cPanel - Domains - Subdomains icon

    • If you are using the Paper Lantern theme, in the DOMAINS section of the cPanel home page, click Subdomains:

      cPanel - Domains - Subdomains icon

  3. Under Modify a Subdomain, locate the subdomain, and then click Manage Redirection.
  4. Click Disable Redirection.

Deleting a subdomain

When you no longer need a subdomain, you can delete it.

To delete a subdomain, follow these steps:

  1. Log in to cPanel.
    If you do not know how to log in to your cPanel account, please see this article.
  2. Open the Subdomains tool:
    • If you are using the Jupiter theme, on the Tools page, in the Domains section, click Subdomains:

      cPanel - Domains - Subdomains icon

    • If you are using the Paper Lantern theme, in the DOMAINS section of the cPanel home page, click Subdomains:

      cPanel - Domains - Subdomains icon

  3. Under Modify a Subdomain, locate the subdomain that you want to delete, and then click Remove.
  4. Click Delete Subdomain to confirm the deletion.

    When you delete a subdomain, its folder and files are not deleted. You must delete the folder and files manually.

More Information

For more information about subdomains, please visit http://en.wikipedia.org/wiki/Subdomain.

Register Your Domain Name

Article Details

Related Articles

Show More

Did you find this article helpful? Then you'll love our support. Experience the A2 Hosting difference today and get a pre-secured, pre-optimized website. Check out our web hosting plans today.

We use cookies to personalize the website for you and to analyze the use of our website. You consent to this by clicking on "I consent" or by continuing your use of this website. Further information about cookies can be found in our Privacy Policy.