Skip to content

[Registrar] Address review feedback on transfer docs#28933

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

[Registrar] Address review feedback on transfer docs#28933
dcpena merged 9 commits into
cloudflare:productionfrom
mhsu:mhsu/registrar-transfers-update3

Conversation

@mhsu

@mhsu mhsu commented Mar 11, 2026

Copy link
Copy Markdown
Contributor

Summary

Addresses Jared Weeks' review feedback on the recently rewritten domain transfer guide. Four issues fixed:

  1. Auth code expiration — Removed unverifiable "5-14 days" claim. Replaced with "usually only valid for a limited period." Trimmed redundant sentences about code invalidation.
  2. GoDaddy domain forwarding — Added note to disable domain forwarding before transferring from GoDaddy (causes transfer rejection). Added to both the transfer guide and troubleshooting page.
  3. ICANN one-year extension — Qualified the blanket "ICANN requirement" language to clarify it applies to gTLD transfers only. Country-code domains (like .uk) follow their own registry policies.
  4. Cost bullet — Rewrote to highlight Cloudflare's at-cost pricing with no markup. Noted that some country-code domains have no transfer fee.

Also updated the "Total time" estimate from "Around 5 business days" to "Up to 10 days, depending on your registrar."

Files changed

  • src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx — 5 edits
  • src/content/docs/registrar/troubleshooting.mdx — 3 edits

@mhsu
mhsu requested a review from dcpena as a code owner March 11, 2026 20:48
@mhsu
mhsu requested a review from a team March 11, 2026 20:48
@github-actions github-actions Bot added product:registrar Related to Registrar product size/m labels Mar 11, 2026
@mhsu

mhsu commented Mar 11, 2026

Copy link
Copy Markdown
Contributor Author

@dcpena some smaller tweaks to the registrar transfer page based on customer feedback. Lmk if I can help clarify anything.

@mhsu
mhsu force-pushed the mhsu/registrar-transfers-update3 branch from 1c86d3d to a46793e Compare March 16, 2026 22:05
@mhsu

mhsu commented Mar 16, 2026

Copy link
Copy Markdown
Contributor Author

Recent commits rebase this branch on production to resolve merge conflicts

RebeccaTamachiro
RebeccaTamachiro reviewed Mar 17, 2026
View reviewed changes
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated

Before you can transfer, you must first [add your domain to Cloudflare](#1-add-your-domain-to-cloudflare).

:::note
You cannot [enter an authorization code](/registrar/troubleshooting/#cannot-find-where-to-enter-your-authorization-code) until your domain is active on Cloudflare. If your domain is registered with a website builder platform (such as Block, Shopify, Squarespace, or Wix), you may not be able to change nameservers while the domain is registered there. Refer to [Transfer from website builders](#transfer-from-website-builders) for the recommended workaround, or [Troubleshoot failed domain transfers](/registrar/troubleshooting/) if you are running into issues.
:::

<Render file="icann-unverified-email" product="registrar" />

@RebeccaTamachiro RebeccaTamachiro Mar 17, 2026

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.

I think @dcpena just recently added this. Maybe it was removed by mistake when resolving conflcts?

@mhsu mhsu Mar 21, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

updated

RebeccaTamachiro
RebeccaTamachiro reviewed Mar 17, 2026
View reviewed changes
Comment thread src/content/docs/registrar/get-started/transfer-domain-to-cloudflare.mdx Outdated
@@ -34,7 +34,7 @@ Confirm the following before you start:
- Your account at your current registrar is active. If your domain has expired, renew it at your current registrar first.

:::note
If your domain recently expired and you renewed it, wait at least 45 days after the original expiration date before transferring. Otherwise, the registry may not add the extra year. For details, refer to [Why did my domain's expiration date change?](/registrar/faq/#my-domains-registration-was-not-extended-by-one-year-after-transferring-to-cloudflare).
Most transfers add one year to your registration. [Learn when this does not apply](/registrar/faq/#my-domains-registration-was-not-extended-by-one-year-after-transferring-to-cloudflare).

@RebeccaTamachiro RebeccaTamachiro Mar 17, 2026 •
edited
Loading

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.

I was a bit confused as to how this note relates to the bullets around it. After reading through the FAQ, I understood it has to do with renewing at the previous registrar but, as it is, the context is a bit lost and it's not super clear that this note is adding to the previous point that tells them to renew it.

@mhsu mhsu Mar 21, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

updated

@mhsu

mhsu commented Mar 21, 2026

Copy link
Copy Markdown
Contributor Author

Addressed both of Rebecca's review comments:

  1. Restored the ICANN unverified email render — moved it to after the notes block (before the "Before you begin" section), which keeps it visible upfront without burying it in the checklist.
  2. Restored the 45-day note with original language — moved it out of "Before you begin" and into the intro notes block as the second note, so it sits in context with the other pre-transfer caveats. The connection to the "renew before transferring" bullet was clearer here than inside the collapsible.
    Also added a new Email verification required section to the troubleshooting page covering:
  • ICANN's 15-day verification window and hold behavior
  • When verification is triggered (registrant email differs from account email)
  • The .mx, .nz, .ca special case where verification comes from noreply@emailverification.info

mhsu added 9 commits March 23, 2026 09:59
@mhsu
[Registrar] Rewrite transfer page and add registration limits trouble…
75d0be2 
…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
[Registrar] Simplify transfer timeline language in opening paragraph
eda60f1
@mhsu
[Registrar] Address PR review feedback and restore grace period trans…
d34a334 
…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)
@mhsu
[Registrar] Simplify transfer page, move details to troubleshooting
13759ba 
- 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
[Registrar] Restore auth code callout in opening note block
531077c
@mhsu
[Registrar] Address review feedback on auth codes, GoDaddy proxy, and…
f681f63 
… ccTLD transfer pricing
@mhsu
[Registrar] Replace unverified GoDaddy domain forwarding claim with a…
b7ba234 
…ccurate transfer guidance
@mhsu
[Registrar] Simplify 45-day transfer registration language and move d…
41d3d0a 
…etail to FAQ
@mhsu
[Registrar] Address review feedback: restore notes and add email veri…
2ba1920 
…fication section
@mhsu
mhsu force-pushed the mhsu/registrar-transfers-update3 branch from 62f2280 to 2ba1920 Compare March 23, 2026 16:59
@mhsu

mhsu commented Mar 23, 2026

Copy link
Copy Markdown
Contributor Author

Rebased on prod to resolve merge conflicts

@dcpena
dcpena merged commit 9caa3d7 into cloudflare:production Mar 24, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

2 more reviewers
@RebeccaTamachiro RebeccaTamachiro RebeccaTamachiro left review comments
@dcpena dcpena dcpena approved these changes
Reviewers whose approvals may not affect merge requirements

Assignees

@dcpena dcpena

Labels

product:registrar Related to Registrar product size/m

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@mhsu @RebeccaTamachiro @dcpena