Skip to content

[Registrar] Add troubleshooting section to transfer page#29285

Open
mhsu wants to merge 10 commits intocloudflare:productionfrom
mhsu:mhsu/registrar-transfers-update4
Open

[Registrar] Add troubleshooting section to transfer page#29285
mhsu wants to merge 10 commits intocloudflare:productionfrom
mhsu:mhsu/registrar-transfers-update4

Conversation

@mhsu
Copy link
Copy Markdown
Contributor

@mhsu mhsu commented Mar 24, 2026

Adds a 'Having issues?' section to the bottom of the transfer guide with direct links to the most common troubleshooting scenarios. Previously, the 'Troubleshooting' page was only text-linked from this main transfers page and not easy to discover. This changes that.

  • Adds a named 'Having issues?' section with links to 6 common issues (locked domain, invalid auth code, transfer rejected, etc.)
  • Catch-all link to the full troubleshooting page at the bottom

mhsu added 10 commits March 23, 2026 09:59
…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.
…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 review from a team and dcpena as code owners March 24, 2026 16:06
@github-actions github-actions bot added product:registrar Related to Registrar product size/m labels Mar 24, 2026
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.

This information is captured in the note that's in this partial file. If you want to see the exact note, it's the second note on this page.

https://github.com/cloudflare/cloudflare-docs/pull/29285/changes#diff-74ed41e19e66517fe60d2f24bfedf5f1ff6013eb336240ab99f515fe471010ddR26

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