Skip to content

[Hostname routing] Point to Custom IPs dashboard UI; document automatic Split Tunnel inclusion for initial resolved IPs - #32754

Open
nikitacano wants to merge 1 commit into
productionfrom
ncano/initial-resolved-ip-custom-ips-auto-split-tunnel
Open

[Hostname routing] Point to Custom IPs dashboard UI; document automatic Split Tunnel inclusion for initial resolved IPs#32754
nikitacano wants to merge 1 commit into
productionfrom
ncano/initial-resolved-ip-custom-ips-auto-split-tunnel

Conversation

@nikitacano

@nikitacano nikitacano commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Summary

Two related fixes for initial resolved IP documentation, now that the Networking > IP addresses > Address space > Custom IPs UI is live in production.

1. Point to the live Custom IPs dashboard UI

Previously documented as Zero Trust > Team & Resources > Devices > Device profiles (the only UI available at the time). Now that Custom IPs is live, changed to Networking > IP addresses > Address space > Custom IPs, with a Go button:

  • configure-initial-resolved-ips.mdx — Prerequisites, "Check your current range", "Update your range"
  • The GA changelog's Rollout paragraph
  • Re-added the dash-route entry to core-manually-defined.json for the deeplink

2. Document automatic Split Tunnel inclusion (WDAPI-4489)

Per WDAPI-4489, the Cloudflare One Client automatically:

  • Include mode: always includes the default initial resolved IP range (172.64.128.0/20) and the entire 2606:4700:0cf1::/48 IPv6 range
  • Exclude mode: always strips those same ranges out of any configured exclusions

This happens at runtime on the device — it's not stored in the device profile and not returned via the public API (same pattern as Microsoft 365 IP exclusions). The 2606:4700:0cf1::/48 IPv6 range also covers device IPs and Cloudflare source IPs on IPv6, so all Cloudflare One IPv6 Split Tunnel configuration for these features is now unnecessary.

Changes:

  • New Automatically managed ranges section in split-tunnels.mdx — the canonical explanation, cross-referenced everywhere else below
  • reserved-ips.mdx — updated both the Exclude mode and Include mode sections
  • configure-initial-resolved-ips.mdx — replaced the blanket "update your Split Tunnel configuration" instruction with "not required for the default range; only for custom ranges"
  • Cloudflare Mesh routes.mdx (Hostname routes prerequisites) and client-devices.mdx (Split Tunnel Include mode list) — removed the token IP / IPv6 rows from the manual-configuration instructions

@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Review

⚠️ 2 warnings found in commit 12e54bd.

👉 Fix in your agent 👈
Fix the following review findings in PR #32754 (https://github.com/cloudflare/cloudflare-docs/pull/32754).

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-f531142c68cf · Imprecise IPv6 Split Tunnel auto-management claim
- **File:** `src/content/docs/cloudflare-one/networks/connectors/cloudflare-mesh/routes.mdx` line 238
- **Issue:** Line 238 states that "all Cloudflare One IPv6 ranges" are automatically routed through Cloudflare. However, the linked Split Tunnels page only identifies the single prefix `2606:4700:0cf1::/48` as automatically managed, covering device IPs, Cloudflare source IPs, and Gateway initial resolved IPs. The broader wording could mislead readers into thinking any additional or custom Cloudflare One IPv6 ranges are also auto-managed.
- **Fix:** Change "all Cloudflare One IPv6 ranges" to the specific automatically managed IPv6 prefix `2606:4700:0cf1::/48`, consistent with the referenced Split Tunnels documentation.

---

## Style Guide Review

### Warnings (1)

#### SG-bf7c449b1967 · Directional words
- **File:** `src/content/docs/cloudflare-one/networks/routes/reserved-ips.mdx` line 85
- **Issue:** Uses the directional word `below` (`the other CGNAT-based ranges below`)
- **Fix:** Replace `below` with a direct reference by name or link, for example `the other CGNAT-based ranges` or `the other CGNAT-based ranges in this section`

Code Review

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

Warnings (1)
File Issue
cloudflare-one/networks/connectors/cloudflare-mesh/routes.mdx line 238 Imprecise IPv6 Split Tunnel auto-management claim — Line 238 states that "all Cloudflare One IPv6 ranges" are automatically routed through Cloudflare. However, the linked Split Tunnels page only identifies the single prefix 2606:4700:0cf1::/48 as automatically managed, covering device IPs, Cloudflare source IPs, and Gateway initial resolved IPs. The broader wording could mislead readers into thinking any additional or custom Cloudflare One IPv6 ranges are also auto-managed. Fix: Change "all Cloudflare One IPv6 ranges" to the specific automatically managed IPv6 prefix 2606:4700:0cf1::/48, consistent with the referenced Split Tunnels documentation.

Conventions

No convention issues found.

Style Guide Review

Warnings (1)
File Issue
cloudflare-one/networks/routes/reserved-ips.mdx line 85 Directional words — Uses the directional word below (the other CGNAT-based ranges below) Fix: Replace below with a direct reference by name or link, for example the other CGNAT-based ranges or the other CGNAT-based ranges in this section
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.

@github-actions

github-actions Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

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

Pattern Owners
/src/content/changelog/ @cloudflare/pm-changelogs, @cloudflare/product-owners
* @cloudflare/product-owners
/src/content/docs/cloudflare-one/networks/connectors/cloudflare-mesh/ @nikitacano, @cloudflare/cf1-reviewers, @elithrar, @cloudflare/product-owners
/src/content/docs/cloudflare-one/ @cloudflare/cf1-reviewers, @elithrar, @cloudflare/product-owners
/src/content/docs/cloudflare-one/team-and-resources/devices/ @cf-rhett, @csujedihy, @lpraneis, @jiulingz, @tojens-ietf, @cloudflare/cf1-reviewers, @elithrar, @cloudflare/product-owners

@github-actions

github-actions Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Preview URL: https://12e54bda.preview.developers.cloudflare.com
Preview Branch URL: https://ncano-initial-resolved-ip-custom-ips-auto-split-tunnel.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/cloudflare-one/networks/routes/configure-initial-resolved-ips/ https://ncano-initial-resolved-ip-custom-ips-auto-split-tunnel.preview.developers.cloudflare.com/cloudflare-one/networks/routes/configure-initial-resolved-ips/
https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-mesh/routes/ https://ncano-initial-resolved-ip-custom-ips-auto-split-tunnel.preview.developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-mesh/routes/
https://developers.cloudflare.com/cloudflare-one/team-and-resources/devices/cloudflare-one-client/configure/route-traffic/split-tunnels/ https://ncano-initial-resolved-ip-custom-ips-auto-split-tunnel.preview.developers.cloudflare.com/cloudflare-one/team-and-resources/devices/cloudflare-one-client/configure/route-traffic/split-tunnels/
https://developers.cloudflare.com/changelog/post/2026-08-11-hostname-routing-ga-public-initial-resolved-ips/ https://ncano-initial-resolved-ip-custom-ips-auto-split-tunnel.preview.developers.cloudflare.com/changelog/post/2026-08-11-hostname-routing-ga-public-initial-resolved-ips/
https://developers.cloudflare.com/cloudflare-one/networks/routes/reserved-ips/ https://ncano-initial-resolved-ip-custom-ips-auto-split-tunnel.preview.developers.cloudflare.com/cloudflare-one/networks/routes/reserved-ips/
https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-mesh/client-devices/ https://ncano-initial-resolved-ip-custom-ips-auto-split-tunnel.preview.developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-mesh/client-devices/

@nikitacano nikitacano changed the title Point to Custom IPs dashboard UI; document automatic Split Tunnel inclusion for initial resolved IPs [Hostname routing] Point to Custom IPs dashboard UI; document automatic Split Tunnel inclusion for initial resolved IPs Aug 14, 2026
@nikitacano
nikitacano enabled auto-merge (squash) August 14, 2026 11:44
@nikitacano

Copy link
Copy Markdown
Contributor Author

/rebase

@cloudflare-docs-bot
cloudflare-docs-bot Bot force-pushed the ncano/initial-resolved-ip-custom-ips-auto-split-tunnel branch from 4142025 to 90c8aaa Compare August 17, 2026 09:35
@abelinkinbio abelinkinbio self-assigned this Aug 17, 2026
…lusion

Two related fixes for initial resolved IPs now that the Networking >
IP addresses > Address space > Custom IPs UI (stratus MR !41739) is
live in production:

- Swap the Zero Trust > Team & Resources > Devices > Device profiles
  UI instructions back to Networking > IP addresses > Address space >
  Custom IPs, with a Go button, in configure-initial-resolved-ips.mdx
  and the GA changelog. Re-add the dash-route entry for this deeplink
  to core-manually-defined.json.

- Per WDAPI-4489, the Cloudflare One Client now automatically includes
  the default initial resolved IP range (172.64.128.0/20) in Split
  Tunnels Include mode, and automatically excludes it (along with the
  entire 2606:4700:0cf1::/48 IPv6 range, which also covers device IPs
  and Cloudflare source IPs on IPv6) from Exclude mode exclusions, at
  runtime on the device. This is not stored in the device profile and
  is not returned via the public API.

  Added a new 'Automatically managed ranges' section to split-tunnels.mdx
  as the canonical explanation, and updated reserved-ips.mdx,
  configure-initial-resolved-ips.mdx, and the Cloudflare Mesh
  routes.mdx / client-devices.mdx docs to stop instructing manual Split
  Tunnel configuration for these ranges. Custom (non-default) initial
  resolved IP ranges still require manual Split Tunnel configuration,
  since it is not confirmed whether the automatic behavior tracks a
  custom range.
@nikitacano
nikitacano force-pushed the ncano/initial-resolved-ip-custom-ips-auto-split-tunnel branch from 90c8aaa to 12e54bd Compare August 17, 2026 17:31
@abelinkinbio
abelinkinbio self-requested a review August 17, 2026 17:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants