How to add a new website as an Addon domain

If you'd like to add a new domain, on which you'd like to run a new website you'll need to add it as an Domain within the "Domains" option.

Addon domains count towards your number of unique websites. Addon domains can have their own unique email accounts.

Amethyst does not allow adding additional domains. Ruby Cloud hosting and all Premium/Business packages allow unlimited Addon domains. These are all single cPanel plans - so all sites share the resources of the individual cPanel.

  1. Log into cPanel and navigate to the Domains Header.
  2. Click on the "Domains" option
  1. Click the Create A New Domain option within the DOMAINS section in cPanel.

  1. Enter your Domain name into the "Domain" option.

Don't include the www. before your domain name! cPanel will automatically create a www. record for you when the domain is created!
  1. Untick "Share document root"

  1. Choose where you would like the website document root to be located
What is a Document Root? (Click to expand)

This is where you want to keep the files for your addon website. This will normally be a subdirectory of your public_html/ directory.

By default, cPanel with use the domain name that you are adding as the name for your subdirectory, e.g public_html/ You can however use any directory name you would like.
If you are going to host several websites, then it is a good idea to place the domain's document root at the top level, so instead of the Document Root saying public_html/ it would simply say This avoids a number of problems that can arise from the use of mod_rewrite in your primary domain.
  1. (Optional) Modify your subdomain name

cPanel creates a subdomain 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.

  1. Click the "Submit" option to add your new addon domain!

In the above examples, either /public_html/ (document root as sub-domain under public_html) or / (document root at top level) would be served to the world as

If you are adding a handful of domains with the same basic name (e.g.,, etc) then you might get a message saying that the Subdomain or FTP User already exists. This is because cPanel will, by default, try to use the first part of the domain name for the Subdomain/FTP username, so you will have to change the default to something else for each of your domains.

Ensure you upload your website files to the correct Document Root folder.

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.

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 cannot be added because it is already associated with another user.

You will be unable to add an Alias or Addon domain if it is already either

  • A primary domain for another Krystal cPanel account
  • An Alias 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.

How did we do?

Powered by HelpDocs (opens in a new tab)
© Krystal Hosting Ltd 2002–