How to add a CNAME record in cPanel Zone Editor

Category: cPanel

A CNAME (Canonical Name) record lets you point a subdomain —such as blog.yourdomain.com or shop.yourdomain.com— to another hostname instead of an IP address. It’s handy when an external service, a CDN, or a platform asks you to validate a domain or route traffic to its hostname. In this guide you’ll see how to add or update a CNAME from cPanel’s Zone Editor, with no commands or server access needed.

Before you start

  • Confirm your domain uses your hosting account’s nameservers. If your domain points to external DNS (for example, Cloudflare or another provider), cPanel’s Zone Editor won’t control those records: you’ll need to copy the same values into that provider’s DNS panel or contact our support team.
  • Have ready the host name (the subdomain you’ll create or change) and the CNAME target (the hostname the external service gave you).
  • Remember the root or apex domain (yourdomain.com, with no subdomain) usually can’t be a CNAME. The DNS standard doesn’t allow it because other records already live at the root (such as MX or NS). Use an A or AAAA record for the root.
  • Check whether a record with that same host already exists. A host can’t have a CNAME and an A/AAAA record at the same time. If one exists, edit or remove it before adding the CNAME.

Add the CNAME record

  1. Log in to cPanel and, under the Domains section, open Zone Editor.
  2. Find the domain you want to work on and click Manage.
  3. Click Add Record and choose the CNAME type in the Type field.
  4. In the Name field, type the subdomain host. You can enter just the subdomain part (for example, blog) or the full name (blog.yourdomain.com); cPanel usually completes the domain for you.
  5. Leave the TTL at its default value (for example, 14400) unless the external service asks for another.
  6. In the destination field, enter the hostname the service gave you. Depending on the theme or provider, this field may appear as destination, value, record, or target.
  7. Click Add Record or Save to apply the change.

Tip: some services give the destination with a trailing dot (service.example.com.). Copy it exactly as provided; cPanel adjusts the format based on the theme.

Verify the change

  • The new CNAME shows up in the Zone Editor list with the correct host and destination.
  • No old A/AAAA record is left behind with the same host.
  • Wait for DNS propagation: changes can take from a few minutes up to 24-48 hours.
  • To check the value, open a web-based DNS lookup tool and search for the CNAME type of your subdomain; it should show the destination you set.
  • If the external service has a “Verify” or “Validate domain” button, use it after propagation.

Common errors

  • “You tried to create a CNAME on the root domain”: use an A/AAAA record for the root; CNAME only applies to subdomains or hosts.
  • “A record with that name already exists”: edit or remove the previous A/AAAA/CNAME record for the same host before adding the new one.
  • The subdomain won’t resolve: make sure the destination is typed correctly, with no spaces and in the exact format the service provided.
  • The change isn’t visible: propagation is probably still pending, or your domain uses external DNS and you edited the wrong zone.
  • Email stopped arriving: if you accidentally placed a CNAME on a host used by mail, remove it; MX records must not coexist with a CNAME on the same host.

Still need help?

If this guide didn’t solve your issue, our team can help you via ticket.

Open ticket Go to my account