Skip to content

[Workers] Correct wildcard route pattern documentation and add zone context#31182

Draft
ask-bonk[bot] wants to merge 1 commit into
productionfrom
opencode/issue30885-20260602101603
Draft

[Workers] Correct wildcard route pattern documentation and add zone context#31182
ask-bonk[bot] wants to merge 1 commit into
productionfrom
opencode/issue30885-20260602101603

Conversation

@ask-bonk
Copy link
Copy Markdown
Contributor

@ask-bonk ask-bonk Bot commented Jun 2, 2026

Summary

Corrects misleading examples in the Workers Routes documentation for hostnames beginning with *.

The previous documentation stated that *example.com/* would not match https://not-example.com/, which contradicts the definition that * matches zero or more of any character. This update fixes the example table and adds a note explaining that route patterns are evaluated within their associated zone, which means cross-domain hostnames like myexample.com or not-example.com would not reach the example.com zone in practice.

Additionally, this update adds subdomain wildcard examples (*sub.example.com/* vs *.sub.example.com/*) to illustrate the more common and relevant scenario where unintended matches can occur within a zone.

Fixes the feedback raised in the community regarding misleading/incorrect wildcard route pattern documentation.

Documentation checklist

  • 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
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 2, 2026

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

Pattern Owners
/src/content/docs/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @korinne, @WalshyDev, @cloudflare/deploy-config, @cloudflare/product-owners, @cloudflare/wrangler, @MattieTK, @cloudflare/dev-plat-leads, @vy-ton

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:workers Related to Workers product size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants