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

…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.
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Review

💡 1 suggestion found in commit 4142025.

👉 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.

---

## Style Guide Review

### Suggestions (1)

#### SG-5c68d6306ef3 · Semicolons
- **File:** `src/content/docs/cloudflare-one/networks/connectors/cloudflare-mesh/routes.mdx` line 231
- **Issue:** Line uses a semicolon to join two independent clauses: `In Include mode, add each range; in Exclude mode, ensure none of them (or their parent ranges) are excluded.`
- **Fix:** Break into two sentences, replacing the semicolon with a period.

Code Review

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

No code review issues found.

Conventions

No convention issues found.

Style Guide Review

Suggestions (1)
File Issue
cloudflare-one/networks/connectors/cloudflare-mesh/routes.mdx line 231 Semicolons — Line uses a semicolon to join two independent clauses: In Include mode, add each range; in Exclude mode, ensure none of them (or their parent ranges) are excluded. Fix: Break into two sentences, replacing the semicolon with a period.
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

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, @hoan-pom
* @cloudflare/product-owners
/src/content/docs/cloudflare-one/networks/connectors/cloudflare-mesh/ @nikitacano, @cloudflare/cf1-reviewers, @elithrar, @cloudflare/product-owners, @hoan-pom
/src/content/docs/cloudflare-one/ @cloudflare/cf1-reviewers, @elithrar, @cloudflare/product-owners, @hoan-pom
/src/content/docs/cloudflare-one/team-and-resources/devices/ @cf-rhett, @csujedihy, @lpraneis, @jiulingz, @tojens-ietf, @cloudflare/cf1-reviewers, @elithrar, @cloudflare/product-owners, @hoan-pom

@github-actions

Copy link
Copy Markdown
Contributor

Preview URL: https://41420257.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
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.

7 participants