Child pages
  • Addon Domains

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Include Page
LIB:_Version
LIB:_Version

(cPanel >> Home >> Domains >> Addon Domains)

Overview

Addon domains allow you to control multiple domains from a single account. An addon domain links a new domain name to a directory in your account, and then stores its files in that directory.

Warning
titleImportant:

Your hosting provider must specify a maximum number of addon domains that you can create (greater than 0) in the Modify an Account interface (WHM >> Home >> Account Functions >> Modify an Account). A value of 0 prevents addon domain creation.

Create an addon domain

To create an addon domain, perform the following steps:

  1. Enter the new addon domain's name in the New Domain Name text box. When you enter the domain name, cPanel automatically populates the Subdomain and Document Root text boxes. 

  2. To create multiple addon domains with the same username and different extensions (for example, example.com and example.net ), manually enter a unique username in the Subdomain text box.
  3. To choose a document root other than the automatically populated value, manually enter the directory name in the Document Root text box.

    Note
    titleNotes:
    • The house icon () represents the cPanel account's home directory.
    • For example, if you enter example1.com in the Directory text box and the cPanel account uses the /home/example home directory, the Addon Domain will exist in the /home/example/example1.com/ directory.
    • Include Page
      LIB:_Banned Docroots Relative to Home Directory
      LIB:_Banned Docroots Relative to Home Directory


  4. To create an FTP account for the new addon domain, select the Create an FTP account associated with this Addon Domain checkbox.
    If you select this checkbox, additional settings will appear:
    • cPanel automatically populates the FTP Username text box. To select a different FTP account username, manually enter the desired username.
    • Include Page
      LIB:_Enter and confirm password and Notes
      LIB:_Enter and confirm password and Notes
  5. Click Add Domain.

To add files to the addon domain’s home directory, click File Manager.

When you create an addon domain in the cPanel interface, the system automatically creates a subdomain. To alter or delete the subdomain after you create it, you may alter or delete the information that the addon domain's website displays.

Also, when you create an addon domain, parked domain, subdomain, or main domain, the system will attempt to automatically secure that domain with the best-available existing certificate. If no certificate exists, the system will generate a self-signed certificate to secure the new domain.

If AutoSSL is enabled for the account that owns the new domain, the system will add a request for an AutoSSL certificate to secure the new domain and install it when it becomes available.

Note
titleNote:

The system stores and displays the addon domain's traffic statistics as part of the subdomain's traffic statistics.



Panel
borderColor#d9d9d9
bgColor#F2F2F2
borderStylesolid

In This Document

Toc no bullet
excludeDocument|Hosting

Related Documentation

Content by Label
showLabelsfalse
max5
showSpacefalse
sortmodified
operatorAND
cqllabel = "domains" and label = "cpanel" and space = currentSpace()
labelsapiguide

For Hosting Providers

Content by Label
showLabelsfalse
max5
showSpacefalse
sortmodified
operatorAND
cqllabel = "domains" and label = "whm" and space in (currentSpace(),"CKB","EA","EA4")
labelsapiguide


Search addon domains

To search the list of addon domains, perform the following steps:

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

The interface lists results that match your search criteria.

Modify Addon Domain

Modify the document root for an addon domain

To modify the document root for an addon domain, perform the following steps:

  1. Click the edit icon () for the addon domain that you wish to manage under the Document Root column.
  2. Enter the new file path to the addon domain's document root in the available text box.

    Note
    titleNote:

    Include Page
    LIB:_Banned Docroots Relative to Home Directory
    LIB:_Banned Docroots Relative to Home Directory


  3. Click Change.

Enable or disable addon domain redirection

To disable or enable redirection of an addon domain, perform the following steps:

  1. Click Manage Redirection for the addon domain that you wish to manage.
  2. To redirect the domain, enter the link to which you wish to redirect the addon domain.
  3. Click Save, or, to disable the redirection, click Disable Redirection.

Remove an addon domain

To remove an addon domain, perform the following steps:

  1. Click Remove for the addon domain that you wish to remove.
  2. Click Yes.

Email accounts in addon domains

To create an email account on an addon domain, use cPanel's Email Accounts interface (cPanel >> Home >> Email >> Email Accounts).

To delete or migrate the contents of email accounts of an addon domain, read our How to Migrate the Contents of Email Accounts in Addon Domains documentation.

Addon and alias domains

Include Page
LIB:_Addon vs. Alias Domains
LIB:_Addon vs. Alias Domains