Understanding Primary, Alias (or Parked), Addon and Sub domains
We understand that domain names can be confusing, especially as there are multiple kinds. This article will help you understand the difference between all the domain options and assist you in assigning additional websites/domain names to your cPanel account - whether that’s a Subdomain, Addon or Alias/Parked domains.
Lets get all your domains under one roof.
This is the main domain for your cPanel account. Your primary domain is served from the public_html/ folder within your home directory. Your home directory is the directory you see when you first connect using FTP e.g. a file located in your home directory at /public_html/mypage.html would be served to the world as http://your.primary.domain/mypage.html
cPanel > Domains > Subdomains
A subdomain is a subsection of your website that can exist as a new website without a new domain name. You can use subdomains to create memorable URLs for different content areas of your site. For example, you can create a subdomain for your blog that is accessible through blog.example.com and www.example.com/blog
Subdomains of primary or addon domains become new unique websites.
To create a subdomain, click the Subdomains icon withn the Domain section in cPanel.
Subdomains can be used to create entirely separate websites, for example if you have www.myprimary.domain you could add a sub-domain to create blog.myprimary.domain.
Ensure you upload your website files to the correct Document Root folder - /public_html/subdomain-document-root/
Email and subdomains
Subdomains are treated separately in terms of email handling - i.e. you can maintain mailboxes for all of your domains/subdomains entirely independently.
cPanel > Domains > Addon Domain
By adding additional new domains as Addon domains, you are setting up a new unique website within your hosting, which means your new domain will have it's own website address e.g. https://www.addon.domain
Any addon domain becomes a new unique website - they create a new vhost (Virtual Host). Also note, that subdomains of addon domains also become new unique websites.
To add an Addon domain, click the Addon Domains icon withn the Domain section in cPanel.
New Domain Name - Enter the new Addon domain here (don't include the www - the system will automatically work with www as well once you're finished).
Subdomain/FTP Username - cPanel creates a subdomain and an FTP account for the Addon domain. The example shown would create a subdomain called myaddondomain.myprimarydomain - this is primarily to allow the statistics software to function correctly. An FTP account will also be created (if you tick the Create an FTP account... tick box) with a login username of e.g. email@example.com and a password matching the one you set in the Password fields.
Document Root - This is where you want to keep the files for your addon website. This is normally a subdirectory of your public_html/ directory, and by default it uses the domain name you are adding as the name of that directory, e.g. public_html/addondomain.co.uk - however, you can chose any directory name you like. If you are going to host several websites, then it is a good idea to place the document root at the top level, so instead of the Document Root (below) saying public_html/domain2.com it would simply say domain2.com. This avoids a number of problems that can arise from the use of mod_rewrite in your primary domain.
In the above examples then either /public_html/myaddondomain.co.uk/myfile.html (document root as sub-domain under public_html) or /myaddondomain.co.uk/myfile.html (document root at top level) would be served to the world as http://myaddondomain.co.uk/myfile.html
Ensure you upload your website files to the correct Document Root folder - /public_html/addon-domain-document-root/
Email and Addon Domains
Addon domains are treated separately in terms of email handling - i.e. you can maintain mailboxes for all of your domains entirely independently.
Alias (or Parked) Domain
cPanel > Domains > Aliases
Alias or parked domains don't have any hosting directly attached to them. They can have email accounts and can be forwarded or redirected to other websites.
To add an Alias domain, simply click the Aliases icon within the Domains section in cPanel.
Enter the new domain and click 'Add Domain'.
Once you add an Alias domain to your cPanel account you'll need to add a Redirect - by clicking on 'Manage Redirection' next to the domain you've added and enter the URL to redirect to. Once you've done this the Alias domain will open the website it's redirected to.
Email and Alias Domains
Alias domains are treated separately in terms of email handling - i.e. fred@myprimarydomain is a completely different mailbox account to fred@myaliasdomain
Reducing your Unique Websites
Your Primary domain, any addon domains and any subdomains of your primary/addon domains each count towards your unique websites, as they create a new vhost (Virtual Host) - you can run a totally separate website on your primary domain, any addon domains and any subdomains of your primary or addon domains.
If you are only using an addon domain for email, you can remove it and re-add it as an alias domain.
You will need to remove any subdomains of the addon domain before you can delete it (be sure to note their unique Document Root before you delete them if you plan to re-add them once you've added the domain as an alias).
If you have existing email accounts using this addon domain (or subdomains) their email files will not be deleted when you remove the addon domain or subdomains. Simply re-add the domain as an alias and recreate the subdomains (using the exact same Document Root you noted above) and the mailboxes will be accessible again.
Errors when adding an alias or addon domain
When adding a domain name which is already assigned to another Krystal cPanel account on another server, you will see this message.
When adding a domain name which is already assigned to this or another Krystal cPanel account on this server, you will see this message.
In the case above, the domain krystal.co.uk cannot be added because it is already associated with another user.
You will be unable to Park(alias) or Addon a domain if it is already either
- A primary domain for another Krystal cPanel account
- An alias (parked) domain or Addon domain on another Krystal cPanel account - even the same one you are working with.
If you need help figuring out where the domain has been duplicated, please raise a support ticket from your Krystal Client Area.