How to Create and Manage Addon Domains in cPanel: A Complete Hosting Guide

by

Hosting multiple websites on a single cPanel account is one of the most powerful features the platform offers, and it’s made possible through addon domains. Whether you’re a developer managing client sites, a small business owner expanding your online presence, or a reseller testing new projects, addon domains let you run completely separate websites — each with its own domain name, content, and visitors — all from one hosting account and one control panel.

Unlike subdomains (which are extensions of your primary domain like store.yourprimarysite.com), an addon domain functions as an entirely independent website. Visitors see yoursecondsite.com in their browser bar, and the files, email accounts, and databases powering it live in a dedicated directory under your cPanel account. This guide walks through everything you need to know: how to create an addon domain, how the underlying folder structure works, how to manage email and databases for each domain, and how to troubleshoot the most common issues that arise.

Understanding How Addon Domains Work in cPanel

Before creating an addon domain, it helps to understand what happens behind the scenes. When you add an addon domain, cPanel performs several automated tasks:

  1. Creates a document root folder — typically public_html/addondomain.com or public_html/secondarysite (you can customize this path)
  2. Sets up Apache virtual host entries so the web server knows to serve files from this folder when a visitor requests your new domain
  3. Creates a subdomain — internally, cPanel treats addon domains as parked subdomains of your primary domain (e.g., addondomain.yourprimary.com)
  4. Optionally creates an FTP account so you can upload files directly to the addon domain’s folder

Your primary domain’s files stay in public_html/, and each addon domain gets its own folder inside or alongside it. This separation is what makes addon domains genuinely independent — nothing in your primary site’s directory structure interferes with the addon domain’s files.

Addon Domains vs. Parked Domains vs. Subdomains

These three features are often confused. Here is the distinction:

  • Addon Domain: A completely new website with its own domain name, content, and folder. Example: You have myhosting.com and add myclientsite.com as a standalone site.
  • Parked Domain (Alias): An additional domain name that shows the exact same content as your primary domain. Example: You own both myhosting.com and myhosting.net — both display identical content.
  • Subdomain: A prefix of your primary domain pointing to a subfolder. Example: blog.myhosting.com serves files from public_html/blog/.

Step-by-Step: How to Create an Addon Domain in cPanel

Follow these instructions to add a new domain to your cPanel account. You will need the domain name already registered and pointing to your server’s nameservers — or at least have an A record pointing to your hosting IP address.

  1. Log into cPanel using your hosting provider’s login link (typically https://yourdomain.com/cpanel or https://yourdomain.com:2083).
  2. Navigate to “Domains” or “Addon Domains” under the Domains section of the cPanel dashboard. In newer cPanel versions (v98+), look for the “Domains” icon directly.
  3. Enter the new domain name in the “Create a New Domain” field. Type it without www — cPanel handles www automatically.
  4. Set the document root (optional but recommended). cPanel auto-fills public_html/yourdomain.com. You can change this if you prefer a shorter path like public_html/site2. Write this path down — you will upload your site files here.
  5. Create an associated FTP account (optional). If you plan to let someone else manage files for this site (a client or freelancer), check “Create an FTP account” and set a username and password. This gives them access only to this addon domain’s folder, not your primary domain.
  6. Click “Submit” or “Add Domain.” After a few seconds, cPanel confirms the addon domain is created and shows the document root path.

Once created, your addon domain is immediately accessible if DNS has propagated. Upload your website files to the document root folder using cPanel’s File Manager or an FTP client.

Managing Email and Databases for Addon Domains

Each addon domain can have its own email accounts, databases, and subdomains — just like your primary domain.

Setting Up Email for an Addon Domain

To create email accounts for your addon domain:

  1. Go to Email → Email Accounts in cPanel.
  2. From the domain dropdown, select your addon domain instead of the primary domain.
  3. Enter the desired email prefix (e.g., info), set a password, and choose a storage quota.
  4. Click Create Account.

Emails like info@addondomain.com now work independently from your primary domain’s email. MX records, SPF, DKIM, and DMARC settings for the addon domain can be managed separately through the Zone Editor — though in most shared hosting setups, these are inherited from the mail server configuration.

Creating Databases for an Addon Domain

If your addon domain runs a CMS like WordPress, you need a dedicated database:

  1. Open Databases → MySQL Databases.
  2. Create a new database (name it something recognizable, like addonsite_wp).
  3. Create a new database user and assign it to the database with all privileges.
  4. Note the database name, username, and password — you need these during the CMS installation.

When installing WordPress or another CMS on your addon domain, use these database credentials during setup. The site files go in the addon domain’s document root, and the CMS stores its data in this database.

Common Addon Domain Issues and How to Fix Them

Even though cPanel makes addon domain setup straightforward, a few problems crop up regularly. Here is how to diagnose and fix the most common ones.

“Domain is already configured” Error

If you see this, the domain may already exist as a parked domain, subdomain, or addon domain in your account. Check under Domains in cPanel to see a complete list. If the domain was recently deleted, DNS cache or Apache configuration files may still reference it — wait 15–30 minutes or contact your hosting provider to clear cached Apache configs.

Addon Domain Shows the Primary Domain’s Content

This usually means DNS has resolved correctly, but the addon domain’s document root is either empty or the Apache virtual host entry is not pointing to the right folder. Verify:

  • The document root path under Domains → your addon domain matches where you actually uploaded your site files.
  • The folder contains an index.php or index.html file.
  • File permissions on the folder are set to 755 and files to 644.

“500 Internal Server Error” After Creating an Addon Domain

A 500 error typically points to a permissions issue or a misconfigured .htaccess file in the addon domain’s folder. Check the addon domain’s public_html/addondomain.com/.htaccess file — if it contains rules meant for the primary domain, they may not apply correctly. Temporarily rename the .htaccess file to see if the error clears, then regenerate it for the specific CMS you are running.

Best Practices for Managing Multiple Addon Domains

If you run several addon domains, these practices will keep things manageable:

  • Use consistent folder naming. Stick with public_html/domainname.com so you always know where each site’s files live.
  • Create separate FTP accounts. For client sites, always use per-domain FTP accounts — never share your primary cPanel credentials. This limits access to exactly one site.
  • Monitor resource usage. Each addon domain consumes disk space, inodes, CPU, and memory. cPanel’s Resource Usage section shows per-domain statistics. If one addon domain spikes traffic, it can affect all other sites on the account.
  • Keep CMS installations updated. An outdated WordPress install on one addon domain can compromise your entire cPanel account through cross-site vulnerabilities. Set up automatic updates or schedule regular maintenance checks.
  • Back up regularly. Most cPanel hosting providers offer partial backup options — you can download a single addon domain’s home directory and its associated databases independently of your primary site.

Key Takeaways

  • Addon domains let you host multiple independent websites under one cPanel account, each with its own domain, files, email, and databases.
  • Creation involves cPanel setting up a document root folder, Apache virtual host entry, and internal subdomain — all automatically.
  • Email accounts and MySQL databases for each addon domain are managed separately from the primary domain through cPanel’s standard tools.
  • Common issues like wrong document root paths, DNS propagation delays, and .htaccess conflicts can be diagnosed and fixed with a few checks.
  • Best practices include consistent folder naming, separate FTP accounts per site, monitoring resource usage, and keeping CMS installs updated across all addon domains.