Skip to content

[DNS] Clarify that assigned nameservers cannot be changed - #33037

Merged
ngayerie merged 3 commits into
cloudflare:productionfrom
ngayerie:ngayerie/dns-nameserver-assignment-guidance
Aug 28, 2026
Merged

[DNS] Clarify that assigned nameservers cannot be changed#33037
ngayerie merged 3 commits into
cloudflare:productionfrom
ngayerie:ngayerie/dns-nameserver-assignment-guidance

Conversation

@ngayerie

Copy link
Copy Markdown
Collaborator

Summary

DEE-3776

What

  • DNS FAQ (dns/faq.mdx): new entry "Why does my new zone have different nameservers than my other zones?" under the existing ## Nameservers section.
  • Nameserver options (dns/nameservers/nameserver-options.mdx): replace a plain sentence in Assignment method with a :::note callout that points to the new FAQ entry and to the Nameserver consistency section.
  • Foundation DNS advanced nameservers (dns/foundation-dns/advanced-nameservers.mdx): new Consistent assignment across new zones subsection that explains why a new zone might get a different color set (blue / gold / orange) and cross-links Account custom nameservers.

Why

Common customer question - Support sees it regularly - "why did my new zone get different nameservers than my other zones, can you reassign it?" The docs already state that assignments cannot be changed after zone creation, but the guidance is buried in prose. This makes the answer easier to find, states the "cannot be changed" rule up front, and points customers to the two supported paths for consistent nameservers across zones (Account custom nameservers on Business/Enterprise, or DNS zone defaults on Enterprise).

Documentation checklist

  • The change adheres to the documentation style guide.
  • No page name or location changes; no redirects needed.
  • Changelog: not applicable - clarification of existing documented behavior, no product change.

@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Review

⚠️ 1 warning, 💡 1 suggestion found in commit a2743ad.

👉 Fix in your agent 👈
Fix the following review findings in PR #33037 (https://github.com/cloudflare/cloudflare-docs/pull/33037).

Before making changes, review each finding and present a brief summary table:
- For each finding, state whether you agree, disagree, or need clarification
- If you disagree (e.g. the fix requires disproportionate effort for minimal benefit,
  or the finding is factually incorrect), explain why
- If you need clarification before deciding, ask those questions
- Then share your plan for which issues to tackle and in what order

After triaging, follow this order:
1. Post a comment on this PR for any findings you are skipping, with the finding ID and your reasoning.
2. Then commit the fixes for the legitimate findings.

The comment must come before the commit — the bot reads PR comments when a new
push triggers a review, so skip comments posted after the push will be missed.

---

## Style Guide Review

### Warnings (1)

#### SG-4d9408d94024 · Headings — trailing punctuation
- **File:** `src/content/docs/dns/faq.mdx` line 95
- **Issue:** ### Why does my new zone have different nameservers than my other zones?
- **Fix:** Remove the trailing question mark from the heading.

### Suggestions (1)

#### SG-d6a51dc51dd3 · Lists — fewer than three items
- **File:** `src/content/docs/dns/faq.mdx` line 108
- **Issue:** The added options list under "To make future zones share the same nameservers..." contains only two bullet items.
- **Fix:** Convert the two-item list to prose or consolidate the items into a single sentence.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

No code review issues found.

Conventions

No convention issues found.

Style Guide Review

Warnings (1)
File Issue
dns/faq.mdx line 95 Headings — trailing punctuation — ### Why does my new zone have different nameservers than my other zones? Fix: Remove the trailing question mark from the heading.
Suggestions (1)
File Issue
dns/faq.mdx line 108 Lists — fewer than three items — The added options list under "To make future zones share the same nameservers..." contains only two bullet items. Fix: Convert the two-item list to prose or consolidate the items into a single sentence.
Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.
/rebase Rebases the PR branch against production. On conflict, attempts to resolve automatically using AI. Stops with an explanation if confidence is not high enough.

Comment thread src/content/docs/dns/foundation-dns/advanced-nameservers.mdx Outdated
Comment thread src/content/docs/dns/faq.mdx Outdated
Comment thread src/content/docs/dns/faq.mdx Outdated
Comment thread src/content/docs/dns/faq.mdx Outdated
Comment thread src/content/docs/dns/nameservers/nameserver-options.mdx Outdated
Comment thread src/content/docs/dns/nameservers/nameserver-options.mdx Outdated

@hannes-cf hannes-cf left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved, once comments are addressed.

DEE-3776

Common customer question: 'why did my new zone get different
nameservers than my other zones, can we reassign it?' The answer is
already documented but easy to miss. Small changes to make it more
discoverable:

- DNS FAQ: new entry 'Why does my new zone have different nameservers
  than my other zones?' explaining the reasons a new zone can be
  assigned a different pair (cross-account conflict, prior deletion,
  parent/child rules, Foundation DNS color rotation) and how to get
  consistent nameservers via Account custom nameservers or DNS zone
  defaults.
- Nameserver options: replace a plain sentence with a callout that
  points to the new FAQ entry and to the Nameserver consistency section.
- Foundation DNS advanced nameservers: new subsection under Nameservers
  hosting and assignment that explains why a new zone might get a
  different color set (blue / gold / orange) and cross-links Account
  custom nameservers.
- faq.mdx: reword 'a different pair' -> 'different nameservers'; drop
  'pair' in the parent/child bullet; use 'set' consistently in the
  delete-and-re-add caveat.
- foundation-dns/advanced-nameservers.mdx: 'The same name is' ->
  'The same domain is', matching the FAQ wording.
- nameservers/nameserver-options.mdx: replace titled ':::note[...]' with
  an untitled ':::caution' (per docs convention and given severity); in
  the adjacent pre-existing caution, replace 'a new pair of nameservers'
  with 'a new set of nameservers' for wording consistency.

Also rebased onto origin/production.
@ngayerie
ngayerie force-pushed the ngayerie/dns-nameserver-assignment-guidance branch from b5eb80f to a2743ad Compare August 28, 2026 10:57
@ngayerie
ngayerie merged commit e7bb86b into cloudflare:production Aug 28, 2026
17 checks passed
rpots pushed a commit that referenced this pull request Aug 28, 2026
* Clarify that assigned nameservers cannot be changed

DEE-3776

Common customer question: 'why did my new zone get different
nameservers than my other zones, can we reassign it?' The answer is
already documented but easy to miss. Small changes to make it more
discoverable:

- DNS FAQ: new entry 'Why does my new zone have different nameservers
  than my other zones?' explaining the reasons a new zone can be
  assigned a different pair (cross-account conflict, prior deletion,
  parent/child rules, Foundation DNS color rotation) and how to get
  consistent nameservers via Account custom nameservers or DNS zone
  defaults.
- Nameserver options: replace a plain sentence with a callout that
  points to the new FAQ entry and to the Nameserver consistency section.
- Foundation DNS advanced nameservers: new subsection under Nameservers
  hosting and assignment that explains why a new zone might get a
  different color set (blue / gold / orange) and cross-links Account
  custom nameservers.

* Style guide: remove directional word from Nameserver consistency link

* Address review feedback from @hannes-cf

- faq.mdx: reword 'a different pair' -> 'different nameservers'; drop
  'pair' in the parent/child bullet; use 'set' consistently in the
  delete-and-re-add caveat.
- foundation-dns/advanced-nameservers.mdx: 'The same name is' ->
  'The same domain is', matching the FAQ wording.
- nameservers/nameserver-options.mdx: replace titled ':::note[...]' with
  an untitled ':::caution' (per docs convention and given severity); in
  the adjacent pre-existing caution, replace 'a new pair of nameservers'
  with 'a new set of nameservers' for wording consistency.

Also rebased onto origin/production.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:dns Issues or PRs related to DNS size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.