[Support Guide] What are the NETLIFY and NETLIFYv6 type DNS records? How do I delete these records?

short answer

The DNS record types of NETLIFY and NETLIFYv6 are special “alias” records within Netlify DNS. They will return the IP addresses for the closest CDN nodes based on the IP address of the system making the DNS lookup.

dns_api example.com- example.com 400 - link exists, all config must be empty

Are you seeing an error like this one?

This happens when you try to create an A or AAAA type DNS record and there is a conflicting NETLIFY or NETLIFYv6 type record.

Before you can create the A or AAAA record, you must first delete NETLIFY or NETLIFYv6 record. Once the NETLIFY types are deleted the A or AAAA record can be created and no error will occur.

Note, it is the NETLIFY type record which points that name to Netlify. If you delete the NETLIFY (and NETLIFYv6) type records, it will take the site offline at Netlify.

However, in most cases you are creating the A record precisely to move domain to some other service. If so, deleting the NETLIFY type record is the correct step before making the A record.

two important facts about NETLIFY and NETLIFYv6 type records

  1. These records only connect domain names to IP addresses.
  2. These records do not control which site the domain name is linked to (if any).

Note, you will only have NETLIFYv6 records if you enabled IPv6 support for your domain - something which is optional. Going forward in this guide, I’m going to just call them “NETLIFY type records” but, when I write this, I mean both “NETLIFY and NETLIFYv6 type records”.

#1: these records only connect the domain names to IP addresses

The records will return an IPv4 IP address for NETLIFY type records and IPv6 address for NETLIFYv6 records.

Many different IP addresses will be returned if repeated requests are made and this is normal. The different IP addresses point to different CDN nodes. Almost all locations will have multiple CDN nodes handling requests for that geographic area. So you can, will, and should get more then one IP address if you make repeated lookups for the same NETLIFY type record.

#2: these records don’t control the site shown

The record value will show the name of the first site the domain is linked to. This value doesn’t change if domain name is moved to a new site or if the original site is deleted.

The DNS record values don’t update currently because they don’t technically need to. The value doesn’t control anything related to the site and is cosmetic only. However, there is a feature request to change this behavior as this is a common source of confusion.

Even if you delete the domain from all sites, the NETLIFY type records will still exist. Also, if you move a domain name to a new site, the value will show the original site. It will show the original site name regardless of how many times you move it or, again, even if the original site is deleted entirely. You can move the domain to a new site and the NETLIFY record will still show the first site it was added to, a site which might not even exist anymore. (There is a feature request to automatically change the record when name is moved to a different site.)

So, why doesn’t the value update? That answer is because of point two above - these records do not control which site is shown. The hostname shown in the web UI never appears in the DNS responses. Historically, these records were not updated because it wasn’t strictly necessary. Again, the domain name in the value isn’t returned in the DNS response. That value is purely cosmetic and is actually never used in any way.

Finally, I want to answer a question some of you might have, which is:

  • What does control which site is shown for a domain name?

The setting which controls the site shown for a specific domain name is in the site settings, not the DNS settings. It is the setting: Site Name > Settings > Domain management > Custom domains. This is known as the “custom domain” setting for the site.

So, for a domain to point to a site, there are two requirements:

  1. The domain name must point to an IP address at Netlify (which is what these NETLIFY records do).
  2. The domain name must be added as a “custom domain” under the site settings.

The site shown for a domain name is controlled completely by the site custom domain setting and not the DNS records. Again, the DNS records point to IP addresses and nothing else.

Summary

I hope this clarifies the (admittedly confusing) details about the NETLIFY type DNS records. The DNS records only point to IP addresses that Netlify uses for our CDN. It is the site setting that controls what site we show for a domain, not the DNS records.

UPDATE: These records used to be locked and required assistance from our support team to unlock. However, this changed in January of 2021. You can now delete these records at any time without needing to request them to be unlocked.

Nameservers seem correct but no A record
Delete NETLIFY type DNS records
[Support Guide] Why do DNS / SSL changes take up to 48 hours to propagate? (TTL)
Unlock A Record management
DNS Zone issue - this domain already exists
Remove Netlify DNS record
Unlock or delete NETLIFY DNS record
Need Suppor for Netlify DNS Record Removed
Unable to add A record (A: 400 - link exists, all config must be empty)
Not sure how to set up a Netlify subdomain
Redirecting to namesilo results in 'page not found'
Netlify doesn't allow to add A records anymore and forcing to change nameservers
"link exists, all config must be empty"
Unlock root Domain
DNS Record Error
Delete DNS record -> "This is a system record that cannot be managed directly"
Unlock My DNS Record
Remove one bad CNAME from the dns record
[Support Guide] DNS Quick Start - How to set up DNS
After new build some users are getting ssl error "ERR_SSL_PROTOCOL_ERROR"
Deleted domain alias But DNS record remains
Unlock my NETLIFY DNS records
Need DNS unlock
Trying to connect TeeSpring
Dns_api semperbot.org - semperbot.org/A: 400 - link exists, all config must be empty
Deletion of Netlify DNS Record
A Record Add Issue
Can't remove sub-domain in DNS settings
Unlock NETLIFY DNS record
Deletion of NETLIFY and NETLIFYv6 DNS record
DNS issue with CNAME record
Removed sub-domain alias did not remove the dns record entry
Certificate is taking more than 24 hours
DNS record still exists after removing domain
Zealous-roentgen-66a2be.netlify.app
"link exists, all config must be empty"
Can't add A record to dns
Please help with 'Delegate your domain to Netlify'
Added domain accidentally and can't remove
Unlock DNS please
Add a and aaaa records
Removing NETLIFY DNS entries
Help:This is a system record that cannot be managed directly
"link exists, all config must be empty"
"link exists, all config must be empty"
Not found on Subdomain
Adding domain issues "Check DNS configuration"
Remove DNS Record
I can't remove DNS
[Netlify Support] DNS Entries need to be Deleted
Remove all DNS records on my domain
I need to unlock my DNS records
Link already exists
Unlock NETLIFY DNS record to A record change
Use Apex domain to point to another resource
Dns updating issue. trying to add A record from webflow
Completely remove accidentally added subdomain
Redirects returning http 500 - dns issue
Network is unreachable for root domain
Need help removing netlify dns records
How to add a Subdomain in Netlify
Security cert not renewing
NetlifyDNS does not update to new repo
Titikpintar-marketing-site / titikpintar.id not working
Inability to create a CNAME DNS record to redirect to a new website
Removing netlify domain from site doesn't remove NETLIFY records from the domain
I have removed DNS to my custom domain name but it still exists
Can I move a domain from one site to another?