Managing CNAME Records

Table of Contents


You can manage CNAME records in DNSimple using the DNS record editor.

The instructions in this article assume you’re familiar with the CNAME record format and usage.

Adding a CNAME record

To add a CNAME record

  1. In the record editor, click , and select from the dropdown menu. screenshot: add cname record
  2. Enter the CNAME record information. screenshot: create new CNAME record form
  • Name: the subdomain you want to create the record for, without the domain name. For example, if you want to represent www.example.com enter www. This field cannot be left blank.
  • Content: the target host name this host will point to. It must be a host name (e.g. blog.dnsimple.com) and not a URL (e.g. http://blog.dnsimple.com or http://blog.dnsimple.com/post are invalid).

As with any other DNS record, you can configure:

Click Add Record to confirm and create the record.

The record is created and visible in the record list. screenshot: new cname record shown

Attempting to add a new record where a CNAME exists

You cannot add a new record where a CNAME exists. A CNAME record points a whole subdomain to another name in the domain name system. If you have another record on that subdomain, you can’t add a CNAME, as that CNAME would render the other records useless.

For example:

There’s an MX record on email.example.com, and you try to add a CNAME on that exact subdomain (email.example.com). If you added the CNAME, it would override the subdomain (email.example.com), and render the MX record useless, which stops your email. To counter this potential error, the domain name system doesn’t allow other records alongside a CNAME.

You can achive similar behavior to CNAME records with an ALIAS record. If you want a sub-domain to always resolve to the IP address of another domain, you can use an ALIAS record pointing to that domain. You should only do this if you absolutely need it, as the ALIAS record has a small amount of additional overhead when compared to A and CNAME records.

Updating a CNAME record

To update a CNAME record

  1. In the record editor, search for the record and click on the pencil icon to edit it. screenshot: edit cname record

  2. Update the information and click to save the record.

Removing a CNAME record

To remove a CNAME record

  1. In the record editor, search for the record and click on the trash icon to delete it. screenshot: delete cname record

  2. Confirm the dialog to delete the record.

Have more questions?

If you have more questions or need assistance setting up CNAME records, just contact our support team, and we’ll be happy to help.