Skip to content

[Registrar] Rewrite transfer page and add registration limits troubleshooting#28780

Merged
dcpena merged 5 commits into
cloudflare:productionfrom
mhsu:mhsu/registrar-transfers-update2
Mar 9, 2026
Merged

[Registrar] Rewrite transfer page and add registration limits troubleshooting#28780
dcpena merged 5 commits into
cloudflare:productionfrom
mhsu:mhsu/registrar-transfers-update2

Conversation

@mhsu

@mhsu mhsu commented Mar 5, 2026

Copy link
Copy Markdown
Contributor

Rewrites the "Transfer your domain to Cloudflare" page for clarity and adds registration limits content to the troubleshooting page. Follows up on #28723 (merged).

Transfer page (transfer-domain-to-cloudflare.mdx):

  • Restructured from a flat 10-step list into two clear phases: (1) Add your domain to Cloudflare, (2) Transfer your registration — so users understand they cannot just paste an auth code like other registrars
  • Inlined content from three partials (requirements, before-you-begin, restrictions) that were only used on this page
  • Added DNSSEC provider links and nameserver change links in collapsible Details blocks
  • Explained why each step is needed (DNSSEC causes resolution failures, zone must be Active before auth code entry, etc.)
  • Added "Registration limits and the one-year extension" Details block with max periods (10 years for most TLDs, 5 for .co), rejection reasons, TLD-specific requirements (.ai 2-year minimum, .uk no extra year), and concrete actionable guidance with examples
  • Replaced vague language throughout: specific ICANN contact-change lock fields (name, organization, email), concrete 45-day expiration rule instead of "may result", specific WHOIS status explanations
  • Added website builder callout near the top linking to the workaround section
  • Changed pcx_content_type from tutorial to how-to

Troubleshooting page (troubleshooting.mdx):

  • Added new "Transfer rejected due to registration limits" section with max registration periods, common rejection reasons, and what users can do (with concrete example: .com with 9.5 years must wait 6 months)
  • Expanded "Domain is in a restricted status" from a single vague sentence to per-status explanations (clientHold/serverHold = suspended, redemptionPeriod = expired past grace, pendingDelete = scheduled for deletion)

Preserves all existing anchors referenced by external pages: #disable-dnssec, #transfer-from-website-builders, #restrictions.

mhsu added 2 commits March 5, 2026 00:13
…shooting

Restructure the transfer-domain-to-cloudflare page into two clear phases
(add domain to Cloudflare, then transfer registration) instead of the
previous flat 10-step list. Inline partials, add DNSSEC/nameserver
provider links, explain why each step is needed, and add registration
limits content with actionable guidance.

Add new troubleshooting section for transfers rejected due to
registration period limits (10-year max for most TLDs, 5-year for .co).
Clarify vague language throughout: specific WHOIS status explanations,
concrete 45-day expiration rule, ICANN contact-change lock details.
@mhsu
mhsu requested a review from dcpena as a code owner March 5, 2026 08:27
@mhsu
mhsu requested a review from a team March 5, 2026 08:27
@github-actions github-actions Bot added product:registrar Related to Registrar product size/m labels Mar 5, 2026

@kodster28 kodster28 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.

Left some comments to address

Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
@kodster28

Copy link
Copy Markdown
Collaborator

/bonk review this PR for duplicative content and other potential issues

@ask-bonk ask-bonk Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Agreeing with most of kodster28's feedback. Posting additional items below — 1 medium issue (missing partial content), 2 low issues, plus suggestions addressing some of the prior review comments.

The restructuring into two clear phases is a good approach, and the troubleshooting additions are solid. The anchor preservation (#disable-dnssec, #transfer-from-website-builders, #restrictions) checks out.

Note: The email-verification partial (Render file="email-verification" product="registrar") was removed in this rewrite. It warned users with unverified account emails that they cannot transfer or register domains. Consider adding that note back — either inline or in the "Before you begin" Details block.

Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
@ask-bonk

ask-bonk Bot commented Mar 5, 2026

Copy link
Copy Markdown
Contributor

Review submitted. Here is what I posted:

Summary: 9 inline comments with suggestions, plus a top-level note about the removed email-verification partial.

Key items:

  • MEDIUM: The DNSSEC provider list (lines 67-82) should use the existing <Render file="dnssec-providers" product="dns" /> partial instead of a hand-maintained subset. The partial has 12+ more registrar links and is shared across 6 pages.
  • LOW: "Block" on line 17 — unclear if this means "Bluehost" or another platform.
  • LOW: "internationalized domain name (IDN)" on line 31 needs a brief clarification for non-technical users.
  • Note: The email-verification partial was dropped — it warned users with unverified emails that they cannot transfer domains. Should be added back to the "Before you begin" block.

I also posted suggestions reinforcing kodster28's prior feedback (opening paragraph density, leading with actions, cross-linking instead of repeating content, and linking "active on Cloudflare" to the full-setup docs).

github run

mhsu added 3 commits March 5, 2026 14:27
…fer scenario

- Break opening paragraph into scannable bullet list (cloudflare#1)
- Lead with action instead of comparison to other registrars (cloudflare#2)
- Replace IDN jargon with plain language and example (cloudflare#3)
- Lead with actionable advice in Restrictions block (cloudflare#5)
- Cross-link 'active on Cloudflare' to full-setup docs (cloudflare#6)
- Replace inlined DNSSEC links with dnssec-providers partial (cloudflare#7)
- Slim 'Add your domain' section to cross-link full-setup page (cloudflare#8)
- Reorder unlock section to put action before context (cloudflare#9)
- Restore 45-day grace period scenario with concrete date example
  and ICANN refund entitlement, matching FAQ content (cloudflare#10)
- Simplify opening: shorter total time bullet, one-line prereq
- Move Restrictions block content to troubleshooting page
- Move registration limits and 'domain not available' Details blocks
  to troubleshooting page as standalone sections with full examples
- Add 45-day grace period note in Before you begin with FAQ link
- Update TLD page to link to troubleshooting instead of removed anchor
- Simplify approve-transfer section for non-technical audience
- Convert caution to note for Active status requirement
- Make authoritative DNS requirement a bullet in Before you begin
- Remove redundant 'Go to Transfer Domains page' text (DashButton CTA)
@mhsu
mhsu requested a review from kodster28 March 5, 2026 23:20
@dcpena
dcpena merged commit e9e72de into cloudflare:production Mar 9, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:registrar Related to Registrar product size/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants