Skip to content
Cloudflare Docs

Set up zone custom nameservers

With zone custom nameservers (ZCNS), each custom nameserver name must be a subdomain of the zone where the custom nameservers are configured.

For example, for a zone domain.test, the ZCNS can be ns1.domain.test and ns2.domain.test but they cannot use a different TLD (ns1.domain.org) nor a different domain (ns1.example.com).

Availability

Zone custom nameservers are available for zones on Business or Enterprise plans. Via API or on the dashboard.

Use zone custom nameservers

Primary zones (full setup)

To create zone custom nameservers:

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

    Go to Records

  2. On Custom nameservers, select Configure.

  3. Select Create custom nameservers just for your-domain.com and enter the subdomains used for the ZCNS names (for example, ns1, ns2, ns3).

  4. Select Save to confirm.

Cloudflare will assign an IPv4 and an IPv6 address to each ZCNS name and automatically create the associated A or AAAA records.

The next step depends on whether you are using Cloudflare Registrar for your domain:

  • If you are using Cloudflare Registrar for your domain, contact Cloudflare Support to add the custom nameservers and IP addresses as glue records to the domain.
  • If you are not using Cloudflare Registrar for your domain, add the zone custom nameservers at your registrar as your authoritative nameservers and as glue (A and AAAA) records (RFC 1912 ↗). If you do not add these records, DNS lookups for your domain will fail.

Secondary zones

If you are using Cloudflare as a secondary DNS provider, you can still set up zone custom nameservers. After following the steps above to create zone custom nameservers, do the following:

  1. Get the ZCNS IPs. You can find them on the DNS Records ↗ page or you can use the Zone details endpoint to get the vanity_name_servers_ips.
  2. At your primary DNS provider, add NS records and, on the subdomains that you used as ZCNS names, add A/AAAA records.
  3. At your registrar, add the zone custom nameservers as your authoritative nameservers and as glue (A and AAAA) records (RFC 1912 ↗).

Remove zone custom nameservers

To remove zone custom nameservers (and their associated, read-only DNS records):

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

    Go to Records

  2. On Custom nameservers, select Disable.

Cloudflare will remove your ZCNS and their associated read-only A or AAAA records.

If you are not using Cloudflare Registrar for your domain, make sure to adjust your nameservers at the registrar, parent zone, or Primary DNS provider accordingly.