← Dns / dns / foundation-dns

Set up advanced nameservers

Advanced nameservers included with Foundation DNS are an opt-in configuration.

Before opting in for advanced nameservers, consider the following:

• The advantages that come with Foundation DNS advanced nameservers are currently not available for custom nameservers. Make sure you only use one at a time.

Some behaviors are different from standard Cloudflare nameservers:

• Wildcard records are still supported but, with advanced nameservers, a wildcard record (*.example.com) will not apply to a subdomain that is an empty non-terminal. An empty non-terminal is a node in the DNS tree that has no records associated with it but has descendants that do, as exemplified below. This behavior is in compliance with RFC 4592 ↗, which defines the role of empty non-terminals in wildcard resolution.

• Subdomain delegation: once a subdomain is delegated via NS records, Cloudflare will not serve any other records (such as A, TXT, or CNAME) on that subdomain from the parent zone, even if those records exist.

To enable advanced nameservers on an existing zone:

1. Opt for advanced nameservers on your zone:

   1. In the Cloudflare dashboard, go to the DNS Records page.

      Go to Records ↗

   2. In the Cloudflare nameservers card, enable Advanced nameservers.

   3. After you refresh the page, the card will display the values for your advanced nameservers NS records.

   Use the Update DNS Settings endpoint to send a PATCH request like the following:

   Required API token permissions

   At least one of the following token permissions is required:

   • Zone DNS Settings Write
   • DNS Write

   Update DNS Settings

   curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_settings" \
   	--request PATCH \
   	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
   	--json '{
   		"nameservers": {
   				"type": "cloudflare.advanced"
   		}
   	}'

   The response body will contain your assigned nameservers in the nameservers object. You will use these nameservers in the next step.

2. Update the authoritative nameservers at your registrar. This step depends on whether you are using Cloudflare Registrar:

   • If you are using Cloudflare Registrar, contact Cloudflare Support to have your nameservers updated.

   • If you are using a different registrar or if your zone is delegated, manually update your nameservers.