Addon Domains

(Home >> Domains >> Addon Domains)

Overview

An addon domain allows a new domain name to link to a subdirectory of your account. The addon domain’s files will be stored in a subdirectory of your public_html (Document Root) directory. Addon domains allow you to control multiple domains from a single account. Addon domains are allowed by your web host in WHM's Tweak Settings interface. (Home >> Server Configuration >> Tweak Settings).

Create an Addon Domain

To create an addon domain:

1. Enter the domain for the new addon domain in the New Domain Name field.
   • Note: When you enter the domain name, cPanel automatically populates the Subdomain/FTP Username field. If you are creating multiple addons with similar domain names (differing only in .com, .net, etc.), be sure to manually enter a unique username into the Subdomain/FTP Username field.
2. Enter the directory that will contain the addon domain’s files in the Document Root field.
3. Enter the password for the addon domain into the Password field.
   • Make sure you use a secure password.
   • You can have cPanel generate a secure pasword for you using the Generate Password feature.
4. Confirm the password in the Password (Again) field.
5. Click Add Domain
   • Note: When you create an addon domain in the cPanel interface, cPanel automatically creates a subdomain. If you alter or delete the subdomain after it has been created, you may affect or delete the information displayed in the addon domain's website.
6. To add files to the addon domain’s home directory, click the File Manager link.
   • Note: To access this addon domain’s home directory in the File Manager, click the link under Document Root.

Note: Web statistics for the addon domain will be found under the subdomain's URL in the statistics application.

Modify Addon Domains

Modify the document root for an addon domain

To modify the document root for an addon domain:

1. Click the notepad icon corresponding to the addon domain that you wish to manage.
2. Enter the new file path that you would like to use as the document root in the available text box.
3. Click Change.

Enable or disable addon domain redirection

To disable or enable redirection of an addon domain:

1. Click the Manage Redirection link which corresponds to the addon domain that you wish to manage.
2. If you wish to redirect the domain, enter the link that you wish to redirect the addon domain to in the available text box.
3. Click Save.
   • To disable the redirect, click Disable Redirection.

Remove an addon domain

To remove an existing addon domain:

1. Click the Remove link which corresponds to the addon domain that you would like to remove.
2. to confirm that you wish to remove the addon domain, click Yes.
3. To keep the addon domain, click No.

Search Addon Domains

To search the list of addon domains:

1. Enter the search criteria into the Search box.
2. Click Go.

Results which match your search criteria will populate the list.

Addon vs. Parked Domains

Additional information about Addon Domains

When you remove an addon domain, any email accounts associated with that domain will no longer appear in the cPanel interface. However, the files for these email accounts will still exist. If you re-add the same addon domain, any email accounts associated with that domain will appear in the cPanel interface.

The email accounts will also appear in the cPanel interface if you change the account’s primary domain name to the removed addon domain name. You can perform this action in WHM’s Modify an Account feature. When you perform this action, the former primary domain name’s mailboxes will not appear in the cPanel interface. However, the files will still exist.