[Support Feedback] Improve account, auth, and domain docs (Fundamentals) by dmmulroy · Pull Request #28991 · cloudflare/cloudflare-docs

dmmulroy · 2026-03-14T01:27:38Z

Summary

Improves documentation for high-volume support topics in Fundamentals, based on an audit of active support macros. These are the responses agents send most frequently — gaps here mean customers cannot self-serve.

Changes

2FA recovery: Add self-service recovery steps, backup code location hints, and verification options
Email MFA: Document email-based MFA enrollment and troubleshooting
Password reset & login: Clarify Apple ID/social login limitations and recovery paths
Account security: Add compromised-account response checklist
Account deletion: Document prerequisites and data retention
Super Admin transfer: Add step-by-step swap procedure
Domain management: Expand move-domain checklist and auto-removal triggers
Compliance docs: Clarify how to request compliance documentation
Member management: Improve role and access documentation
Dashboard SSO: Add SSO testing guidance

Context

These changes are driven by recurring support cases. If you want to see the underlying support data (macro frequency, case volume by topic), reach out to @dmmulroy internally.

…rt macro audit SPM-3037

…A wording, SSO formatting, IdP nav path

dcpena · 2026-03-17T19:05:05Z

src/content/docs/fundamentals/account/account-security/secure-a-compromised-account.mdx

 import { Render } from "~/components";

-If you observe suspicious activity within your Cloudflare account, secure your account with these steps.
+If you observe suspicious activity within your Cloudflare account, secure your account immediately. At a minimum, complete these actions as quickly as possible:


Listing out the items right before each step that is currently a header is redundant. I would remove the ordered list.

dcpena · 2026-03-17T19:06:09Z

src/content/docs/fundamentals/account/change-super-admin.mdx

+2. If needed, remove the previous Super Administrator.

-Then, if needed, remove the previous Super Administrator.
+## Swap Super Administrator email addresses


"Swap" may not be as clear to users. We should use "Change" or "Reassign"

dcpena · 2026-03-17T19:07:09Z

src/content/docs/fundamentals/account/change-super-admin.mdx

+
+If you cannot access the email address associated with the Super Administrator role:
+
+1. **Recover the email account** — contact your email provider to regain access to the mailbox, or set up email forwarding from the old address to one you control.


The items in this ordered list should begin with capital letters if they're going to be full sentences.

dcpena · 2026-03-17T19:09:02Z

src/content/docs/fundamentals/manage-domains/move-domain.mdx

-If you miss this step, Cloudflare will import your proxied DNS records, which might cause your domain to experience a [1000 error](/support/troubleshooting/http-status-codes/cloudflare-1xxx-errors/).
-
-
+1. **Remove DNSSEC configurations** — [disable DNSSEC](/dns/dnssec/) on the domain before moving it. DNSSEC records at the registrar will prevent the domain from activating in the new account.


This should live under a header titled something like "Domain transfer checklist" because it has multiple steps. Warning messages are usually a sentence or two, not a list of steps.

dcpena · 2026-03-17T19:09:46Z

src/content/docs/fundamentals/manage-domains/remove-domain.mdx

+
+1. **Moved** — Cloudflare detects that nameservers no longer point to Cloudflare and marks the domain as **Moved**. An email notification is sent to the account owner.
+2. **Deleted** — For Free zones, Cloudflare automatically transitions the domain from Moved to Deleted after 7 days. At this stage, the domain can still be re-added.
+3. **Purged** — 7 days after being marked Deleted, the zone is permanently purged. Zone settings are not preserved.


Because this is a full sentence, it should begin with "Seven" instead of the number.

dcpena · 2026-03-17T19:27:53Z

src/content/docs/fundamentals/user-profiles/delete-account.mdx

- If you are using a Cloudflare [CNAME setup](/dns/zone-setups/partial-setup/), [update your DNS records](/dns/manage-dns-records/how-to/create-dns-records/#edit-dns-records) at your DNS provider to point to your website IPs or hostnames instead of Cloudflare.
- [Delete payment information](/billing/update-billing-info/#delete-your-current-payment-method)
- (*Optional*) [Download a copy of your invoices](/billing/invoices/#download-invoice). Once deleted, the invoices will no longer be accessible and cannot be re-sent to you.
+Before Cloudflare can cancel your account and delete your personal information, complete the following steps for each domain associated with your Cloudflare account:


Unsure why this was deleted and readded

dcpena · 2026-03-17T19:28:41Z

src/content/docs/fundamentals/user-profiles/delete-account.mdx

+## After deletion
+
+- **Re-register with the same email** — you can sign up for a new Cloudflare account using the same email address. In most cases, the email is available for reuse immediately.
+- **Re-invitation to other accounts** — if you were a member of other Cloudflare accounts or organizations, the account owner will need to re-invite you after you create a new account.


The first list items is confusing. It reads as though we're telling using to re-register with the same email they just deleted. This section can use some revision.

dcpena · 2026-03-17T19:28:59Z

src/content/docs/fundamentals/user-profiles/login.mdx

 * **Different Cloudflare account email as Apple ID**: This option creates a new Cloudflare account. If you want to log in to an existing account, [change your email address](/fundamentals/user-profiles/change-password-or-email/) to match the one used for your Apple ID.

-If you chose to share your email when creating a Cloudflare account with Apple ID and want to set a password and obtain an API key, go to the [Cloudflare dashboard](https://dash.cloudflare.com/login) login page and select **Forgot your password?** to trigger a password reset email.
+##### Shared email (not hidden)


We don't typically use an H5. This should be revised

dcpena · 2026-03-17T19:30:43Z

src/content/docs/fundamentals/user-profiles/multi-factor-email-authentication.mdx

 ## Troubleshoot MFA

-Cloudflare emails are sometimes flagged as spam by the recipient's email service. If you are expecting an authentication token, you should check the spam folder for any Cloudflare emails and configure a filter to allow Cloudflare emails from *[no-reply@notify.cloudflare.com](mailto:no-reply@notify.cloudflare.com)*\_**.**\_
+### When does email MFA trigger?


This heading is not clear and ideally shouldn't leave with a question

dcpena · 2026-03-17T19:30:51Z

src/content/docs/fundamentals/user-profiles/multi-factor-email-authentication.mdx

+Email MFA challenges a login when the client IP address is not recognized for that account. This means you may be prompted for a code when logging in from a new network, device, or location.

-If you still do not receive an email after ensuring your email service is not flagging Cloudflare, contact [Cloudflare Support](/support/contacting-cloudflare-support/).
+### Not receiving the one-time code email


I would revise this based on the section above

dmmulroy requested review from a team, andre-j3sus and dcpena as code owners March 14, 2026 01:27

github-actions bot added product:fundamentals product:radar product:support size/m labels Mar 14, 2026

github-actions bot assigned dcpena and andre-j3sus Mar 14, 2026

dmmulroy added 2 commits March 17, 2026 11:26

docs(fundamentals): improve account, auth, and domain docs from suppo…

2b527a9

…rt macro audit SPM-3037

fix: correct verify-email-address link path

a0fb0b1

dmmulroy force-pushed the support-macros/fundamentals branch from 1970b4e to a0fb0b1 Compare March 17, 2026 15:26

fix(fundamentals): fix Radar URL, zone lifecycle, compliance gate, 2F…

de0b88c

…A wording, SSO formatting, IdP nav path

dcpena requested changes Mar 17, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[Support Feedback] Improve account, auth, and domain docs (Fundamentals)#28991

[Support Feedback] Improve account, auth, and domain docs (Fundamentals)#28991
dmmulroy wants to merge 3 commits intocloudflare:productionfrom
dmmulroy:support-macros/fundamentals

dmmulroy commented Mar 14, 2026

Uh oh!

dcpena Mar 17, 2026

Uh oh!

dcpena Mar 17, 2026

Uh oh!

dcpena Mar 17, 2026

Uh oh!

dcpena Mar 17, 2026

Uh oh!

dcpena Mar 17, 2026

Uh oh!

dcpena Mar 17, 2026

Uh oh!

dcpena Mar 17, 2026

Uh oh!

dcpena Mar 17, 2026

Uh oh!

dcpena Mar 17, 2026

Uh oh!

dcpena Mar 17, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants


		If you cannot access the email address associated with the Super Administrator role:

		1. Recover the email account — contact your email provider to regain access to the mailbox, or set up email forwarding from the old address to one you control.

		If you miss this step, Cloudflare will import your proxied DNS records, which might cause your domain to experience a [1000 error](/support/troubleshooting/http-status-codes/cloudflare-1xxx-errors/).


		1. Remove DNSSEC configurations — [disable DNSSEC](/dns/dnssec/) on the domain before moving it. DNSSEC records at the registrar will prevent the domain from activating in the new account.

Conversation

dmmulroy commented Mar 14, 2026

Summary

Changes

Context

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants