Skip to content

Commit a72c5f7

Browse files
[DNS] Clarify nameserver assignment and consistency (#26291)
* Leverage FAQ gem for initial suggestion * Adjust page structure and revert unnecessary edits * Fix formatting and add hyperlinks * Adjust core messaging * Tangent: fix typo on ACNS and TCNS intro paragraphs * Specify consistency reason for different nameserver types * Consolidate assigment info in one page and adjust links and redirects * Apply suggestion from code review Co-authored-by: Pedro Sousa <[email protected]> --------- Co-authored-by: Pedro Sousa <[email protected]>
1 parent 3d93da4 commit a72c5f7

File tree

7 files changed

+22
-28
lines changed

7 files changed

+22
-28
lines changed

public/__redirects

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -549,6 +549,7 @@
549549
/dns/reference/troubleshooting/ /dns/reference/recommended-third-party-tools/ 301
550550
/dns/zone-setups/partial-setup/convert-partial-to-full/ /dns/zone-setups/conversions/convert-partial-to-full/ 301
551551
/dns/zone-setups/partial-setup/convert-partial-to-secondary/ /dns/zone-setups/conversions/convert-partial-to-secondary/ 301
552+
/dns/zone-setups/reference/nameserver-assignment/ /dns/nameservers/nameserver-options/#assignment-method 301
552553
/dns/zone-setups/troubleshooting/dns-probe-finished-nxdomain/ /dns/troubleshooting/dns-probe-finished-nxdomain/ 301
553554
/dns/zone-setups/troubleshooting/nameservers/ /dns/zone-setups/full-setup/troubleshooting/ 301
554555
/support/dns/ /dns/ 301

src/content/docs/dns/nameservers/custom-nameservers/account-custom-nameservers.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ import { Example, Render, Tabs, TabItem, DashButton } from "~/components";
2222
two: "A",
2323
three: "account",
2424
four: "zones",
25-
five: "account ",
25+
five: "account",
2626
}}
2727
/>
2828

src/content/docs/dns/nameservers/custom-nameservers/tenant-custom-nameservers.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ import { Example, Render, APIRequest } from "~/components";
2323
two: "T",
2424
three: "tenant",
2525
four: "accounts",
26-
five: "tenant ",
26+
five: "tenant",
2727
}}
2828
/>
2929

src/content/docs/dns/nameservers/nameserver-options.mdx

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,25 @@ Refer to the sections below to learn about different nameserver options.
1212

1313
## Assignment method
1414

15-
When you add a domain on a full or secondary setup, Cloudflare automatically assigns your nameservers.
15+
When you add a domain on a [primary (full)](/dns/zone-setups/full-setup/) or [secondary](/dns/zone-setups/zone-transfers/cloudflare-as-secondary/) DNS setup, Cloudflare automatically assigns your nameservers.
1616

17-
The [default assignment method](/dns/zone-setups/reference/nameserver-assignment/) is to use standard nameservers and favor consistent nameserver names across all zones within an account. Nonetheless, in case there are conflicts - for example, if someone else has already added the same zone to a different account - you may get different nameserver names.
17+
The default assignment method is to use [standard nameservers](/dns/nameservers/#standard-nameservers) and favor consistent nameserver names across all zones within an account. Nonetheless, in case there are conflicts, you may get different nameserver names, even for domains that are within the same account.
1818

19-
To have control over what nameservers are assigned for different zones within an account, you can use [account custom nameservers](/dns/nameservers/custom-nameservers/account-custom-nameservers/).
19+
:::caution
20+
To prevent domain hijacking, you can no longer preset Cloudflare nameservers at your registrar before creating the respective zone in Cloudflare. If you preset your nameservers and then add the domain, your domain will be assigned a new pair of nameservers.
21+
:::
22+
23+
These nameserver assignments cannot be changed. However, depending on your subscription, you may have different options for better nameserver consistency.
24+
25+
### Nameserver consistency
26+
27+
The level of consistency you can expect when adding new zones depends on the configured nameserver type.
28+
29+
- For [standard nameservers](/dns/nameservers/#standard-nameservers), since a conflict can be caused by anyone adding the same zone to any other Cloudflare account, the likelihood of your new zone being assigned different nameserver names than your previously existing zones is higher.
30+
31+
- If you use [account custom nameservers](/dns/nameservers/custom-nameservers/account-custom-nameservers/), the only conflict would be between a parent and a child zone, which makes consistent assignment across new zones more likely.
32+
33+
- With [tenant custom nameservers](/dns/nameservers/custom-nameservers/tenant-custom-nameservers/) or [Foundation DNS advanced nameservers](/dns/foundation-dns/advanced-nameservers/#nameservers-hosting-and-assignment), there can still be conflicts caused by two zones with the same name being added to different accounts, but, since access to these features is more restricted, the likelihood of your new zone being assigned different nameserver names than your previously existing zones is lower.
2034

2135
### DNS zone defaults
2236

src/content/docs/dns/zone-setups/full-setup/setup.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ When you start using Cloudflare's nameservers for authoritative DNS and your zon
7777

7878
:::note
7979

80-
Cloudflare automatically assigns nameservers to a domain and these assignments cannot be changed. For more details, refer to [Nameserver assignments](/dns/zone-setups/reference/nameserver-assignment/).
80+
Cloudflare automatically assigns nameservers to a domain and these assignments cannot be changed. For more details, refer to [Nameserver assignments](/dns/nameservers/nameserver-options/#assignment-method).
8181
:::
8282

8383
### Update your registrar

src/content/docs/dns/zone-setups/reference/nameserver-assignment.mdx

Lines changed: 0 additions & 21 deletions
This file was deleted.

src/content/docs/registrar/faq.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ Transferring a domain adds time to the current expiration date, unless your doma
3737

3838
### What happens to my nameservers when I transfer my domain to Cloudflare?
3939

40-
Cloudflare Registrar only supports transfers of domains that are active on a Cloudflare [full setup](/dns/zone-setups/full-setup/). Domains on Cloudflare use [nameservers assigned by Cloudflare](/dns/zone-setups/reference/nameserver-assignment/) to the associated account and those nameservers must remain in place for the domain to be Active.
40+
Cloudflare Registrar only supports transfers of domains that are active on a Cloudflare [full setup](/dns/zone-setups/full-setup/). Domains on Cloudflare use [nameservers assigned by Cloudflare](/dns/nameservers/nameserver-options/#assignment-method) to the associated account and those nameservers must remain in place for the domain to be Active.
4141

4242

4343
### How can I see the status of my domain transfer?

0 commit comments

Comments
 (0)