Knowledge Base

How to configure subdomains in cPanel

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

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. In the Domains section of the cPanel home screen, click Subdomains.
  2. 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.
    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
  3. Click Create. You can now add content to the subdomain by placing files in the subdomain's document root.

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. In the Domains section of the cPanel home screen, click Subdomains.
  2. Under Modify a Subdomain, locate the subdomain that you want to redirect, and then click Manage Redirection.
  3. In the Subdomain Redirection text box, type the redirection destination address.
  4. 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. In the Domains section of the cPanel home screen, click Subdomains.
  2. Under Modify a Subdomain, locate the subdomain, and then click Manage Redirection.
  3. 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. In the Domains section of the cPanel home screen, click Subdomains.
  2. Under Modify a Subdomain, locate the subdomain that you want to delete, and then click Remove.
  3. 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.