[Wallets] Add Cloudflare Wallets handle reservation docs

[h3nrybrown]

Summary

New product section documenting the Cloudflare Wallets handle reservation flow at cloudflare.pay, announced in Announcing Cloudflare Wallets. The blog post is currently the only public source, so nothing published covers how reservations work.

Reviewed with the Agent Payments team. The policy below has been corrected from the first draft: reservations are not final, and Cloudflare reserves the right to reject or reclaim one. Still holding as draft pending the rest of that review.

Five pages under /cloudflare-wallets/:

Page	Type	Covers
index.mdx	overview	What Cloudflare Wallets is, and that handle reservation is the only part open today
wallet-handles.mdx	concept	Allocation, what can be changed after reserving, account binding, trademark reports
reserve-a-wallet-handle.mdx	how-to	The reservation flow, and how to confirm cloudflare.pay is genuine
wallet-handle-requirements.mdx	reference	Length, character, reserved name, and filtering rules
faq.mdx	faq	Cost, plan requirements, published information, and reservation errors

Behaviour and policy documented:

• Handles are allocated first come, first served.
• Cloudflare reserves the right to reject or reclaim a handle reservation at any time, for any reason. Reserving a handle does not grant ownership of a name or any trademark rights.
• No self-service way to change, release, or transfer a handle exists today. Support is the route for those requests.
• Revoking the Cloudflare Wallet Launch Site connected application does not release a handle.
• Deleting a Cloudflare account does not release a handle, and a recreated account does not inherit it.
• Trademark holders can report a handle through the abuse form, consistent with Complaint types.
• cloudflare.pay is a genuine Cloudflare domain. Sign-in happens on dash.cloudflare.com, and the application requests read-only access.
• Handles are not case-sensitive, and the reserved word and profanity filters match on substrings.

Also adds the cloudflare-wallets directory entry and a landing nav link under Build > AI.

Documentation checklist

• Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
• The change adheres to the documentation style guide.
• If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.

[github-actions]

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern	Owners
/.github/CODEOWNERS	@cloudflare/product-owners, @cloudflare/content-engineering, @kodster28
*.ts	@cloudflare/content-engineering, @kodster28
*	@cloudflare/product-owners
/src/content/docs/wallets/	@rohinlohe, @willpapper, @cloudflare/product-owners

[github-actions]

Preview URL: https://0c047066.preview.developers.cloudflare.com
Preview Branch URL: https://wallets-handle-docs.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/wallets/	https://wallets-handle-docs.preview.developers.cloudflare.com/wallets/
https://developers.cloudflare.com/wallets/faq/	https://wallets-handle-docs.preview.developers.cloudflare.com/wallets/faq/

[WillPapper]

LGTM! (I authored the Wallets blog post at https://blog.cloudflare.com/wallets/)

[adlonymous]

the where can I report abuse/spam question feels like it could be more targeted, but otherwise lgtm (I work with the author of the Wallets blog post at https://blog.cloudflare.com/wallets/)

"Where can I report trademark infringements, abuse or spam"

[cloudflare-docs-bot]

Review

⚠️ 3 warnings, 💡 2 suggestions found in commit 0c04706. ⚠️ Part of the review could not complete and will retry on the next push.

👉 Fix in your agent 👈

Fix the following review findings in PR #32568 (https://github.com/cloudflare/cloudflare-docs/pull/32568).

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.

---

## Code Review

### Warnings (1)

#### CR-4a274e7ec213 · Incorrect CODEOWNERS section placement
- **File:** `.github/CODEOWNERS` line 37
- **Issue:** The new `/src/content/docs/wallets/` rule is inserted under the `# AI` section, between Vectorize and AI Search entries, but Wallets is not an AI product.
- **Fix:** Move the Wallets ownership rule out of the `# AI` section, e.g. to a new `# Wallets` section or another appropriate product grouping.

### Suggestions (1)

#### CR-5119356b1c5c · Unused component import
- **File:** `src/content/docs/wallets/index.mdx` line 20
- **Issue:** `LinkButton` is imported in the MDX import block but is never used anywhere in the file.
- **Fix:** Remove the unused `LinkButton` import to keep the import list clean and avoid shipping dead code.

---

## Conventions

### Warnings (2)

#### CV-792b2e852327 · Scope accuracy
- **File:** PR-level finding
- **Issue:** The description claims five pages under /cloudflare-wallets/ are added, but only src/content/docs/wallets/index.mdx and src/content/docs/wallets/faq.mdx appear in the change set; wallet-handles.mdx, reserve-a-wallet-handle.mdx, and wallet-handle-requirements.mdx are absent. The PR also modifies WAF changelog files, a Workers AI changelog file, Workers AI pricing, and Workers AI model files, none of which are mentioned in the description.
- **Fix:** Update the description to accurately reflect which wallet pages are actually added and to account for the WAF and Workers AI changes, or remove unrelated changes from the PR.

#### CV-bc67e227862a · Product or area identified
- **File:** PR-level finding
- **Issue:** Title "[Wallets] Add Cloudflare Wallets handle reservation docs" names only Wallets, but the changed files also cover WAF and Workers AI products.
- **Fix:** Update the title to include the additional affected products or split the unrelated changes into separate PRs.

---

## Style Guide Review

### Suggestions (1)

#### SG-1f42073de123 · Use consistent product name
- **File:** `src/content/docs/wallets/faq.mdx` line 14
- **Issue:** The frontmatter `head` title and description use "Cloudflare Wallets" (plural), but the body repeatedly uses "Cloudflare Wallet handle(s)" (singular "Wallet").
- **Fix:** Use the same product name form throughout the page, likely "Cloudflare Wallets" to match the frontmatter and PR title.

Code Review

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

Warnings (1)

File	Issue
.github/CODEOWNERS line 37	Incorrect CODEOWNERS section placement — The new /src/content/docs/wallets/ rule is inserted under the # AI section, between Vectorize and AI Search entries, but Wallets is not an AI product. Fix: Move the Wallets ownership rule out of the # AI section, e.g. to a new # Wallets section or another appropriate product grouping.

Suggestions (1)

File	Issue
wallets/index.mdx line 20	Unused component import — LinkButton is imported in the MDX import block but is never used anywhere in the file. Fix: Remove the unused LinkButton import to keep the import list clean and avoid shipping dead code.

Conventions

❌ This review could not complete this run; results may be incomplete. It will retry on the next push.

Warnings (2)

File	Issue
PR	Scope accuracy — The description claims five pages under /cloudflare-wallets/ are added, but only src/content/docs/wallets/index.mdx and src/content/docs/wallets/faq.mdx appear in the change set; wallet-handles.mdx, reserve-a-wallet-handle.mdx, and wallet-handle-requirements.mdx are absent. The PR also modifies WAF changelog files, a Workers AI changelog file, Workers AI pricing, and Workers AI model files, none of which are mentioned in the description. Fix: Update the description to accurately reflect which wallet pages are actually added and to account for the WAF and Workers AI changes, or remove unrelated changes from the PR.
PR	Product or area identified — Title "[Wallets] Add Cloudflare Wallets handle reservation docs" names only Wallets, but the changed files also cover WAF and Workers AI products. Fix: Update the title to include the additional affected products or split the unrelated changes into separate PRs.

Style Guide Review

Suggestions (1)

File	Issue
wallets/faq.mdx line 14	Use consistent product name — The frontmatter head title and description use "Cloudflare Wallets" (plural), but the body repeatedly uses "Cloudflare Wallet handle(s)" (singular "Wallet"). Fix: Use the same product name form throughout the page, likely "Cloudflare Wallets" to match the frontmatter and PR title.

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.

[WillPapper]

New changes LGTM