View source for Addon Domains (cPanel/WHM)

==What is an Addon Domain?==
<br>
An addon domain is a secondary domain instance on a cPanel account, but, unlike a subdomain, an addon domain will be created with its own DNS zone file for more thorough DNS routing and DNS record control. This allows for cPanel account user to manage multiple domains under that single account.
*It is important to note that the number of addon domains per cPanel account can be managed by the account package in the WHM interface. 
<br>
==Accessing The Addon Domains Widget==
<br>
To access the addon domains widget in the cPanel account, navigate cPanel control panel by typing http://yourdomain.com/cpanel into the browser address bar: 
*Next login into the account using the cPanel account using:
*#Username
*#Password
**(This information will be provided via email after account creation)
<br>
[[File:cPanel_Account_login.png|center|frame|''cPanel Login'']]
<br />
<br>
Once the cPanel Account has been accessed, navigate to the '''Addon Domains''' widget, located at '''cPanel Home >> Domains >> Addon Domains''':
*Click the widget to begin the creation process or modify an existing addon domain.<br>
[[File:cPanel_Account_Addon_Domain_Widget.png|none|frame|''Addon Domain Widget'']]<br>
<br>
==Creating Addon Domains==
<br>
After clicking on the '''Addon Domains''' widget, the user will be directed to the addon domain page where the domain information and file path will need to be entered.<br>
<br>
[[File:cPanel_Account_Addon_Domain_Page.png|none|frame|''Addon Domain page'']]
<br>
To create the addon domain, perform the following steps:
#Enter the new addon domain's name in the ''New Domain Name'' field. When information is entered into this field, cPanel will automatically populate the ''Subdomain'' and ''Document Root'' fields
#*To create multiple addon domains with the same username and different extensions (I.E. ''example.com'', and ''example.net''), manually enter a unique username in the ''Subdomain'' field.
#To choose a document root (I.E. publishing/public directory for the addon domain) other than the automatically populated value, manually enter the directory name in the ''Document Root'' field.
#Click '''Add Domain''' to finalize the domain creation.
<br>
===Creating FTP Account For a New Addon Domain===
----
<br>
To create an FTP account for the new addon domain, select the ''Create an FTP account associated with this Addon Domain'' checkbox.
<br>
<br>
[[File:cPanel_Account_Addon_Domain_FTP_Setup.png|center|frame|''FTP Setup Options'']]
<br>
*If you select this check, additional settings will appear:
**cPanel automatically populates the ''FTP Username'' text box. To select a different FTP account username, manually enter the desired username.
**Enter and confirm the new password in the appropriate fields.
To finalize the FTP account creation with the newly created Addon Domain, click the '''Add Domain''' button.
<br>
==Modify Addon Domain Settings==
<br>
After clicking the '''Addon Domains''' widget, the user will be direct to the addon domain page. Below the creation options, the existing addon domains can be further modified. As seen below:<br>
<br>
[[File:cPanel_Account_Addon_Domain_Modify.png|none|frame|''Addon Domain Modify'']]
<br>
===Modify the Document Root for an Addon domain===
----
<br>
[[File:cPanel_Account_Addon_Domain_Document_Root_modify.png|right|frame|''Modify Addon Domain Document Root'']]
To modify the document root for an addon domain, please perform the following steps:
#Click the '''"Pencil Icon"''' for the addon domain that you wish to manage under the ''Document Root'' column.
#Enter the new file path to the addon domain's document root in the available field.
#Click the ''"change button"'', to finalize the modification.
When modifying the document root, it is often a common practice to place the addon domain's root directory into the user directory, which is one level higher than the cPanel default /public_html.
*When cPanel creates the document root, by default, it will create the directory in ''"/home/username/public_html/addondomain.com''". To avoid conflicts with "webroot" level hidden files like .htaccess, which can have rules that will apply to subdirectories within the /public_html, it is recommended, in the event that those rules are affecting the subdirectories, to add the directory root to /username directory. This will make the addon domain's document root on the same level as the /public_html, which can keep .htaccess rules from interfering with the addon domain's content.
<br>
===Enable or disable addon domain redirection===
----
<br>
To disable or enable redirection of an addon domain, perform the following steps:
#Click ''Manage Redirection'' next to the addon domain that you wish to manage.
#To redirect the domain, enter the link to which you wish to redirect the addon domain.
#Click ''Save,'' or to disable the redirection, click ''Disable Redirection.''
<br>
[[File:cPanel_Account_Addon_Domain_Manage_Redirection_Modify.png|none|frame|''Modify Addon Domain Manage Redirection'']]
<br>
==Remove An Addon Domain==
<br>
To remove an addon domain, perform the following steps:
#Click ''Remove Icon'' for the addon domain that you wish to remove.
#Click ''Remove''
<br>
[[File:CPanel_Account_Addon_Domain_Remove.png|center|frame|''Addon Domain Removal Page'']]
<br>
----
If any of the above methods to manage cPanel account addon domains are unsuccessful, please don't hesitate to submit a support ticket [https://support.hostek.com here] for further investigation.
[[category:cPanel]]