Skip to content

[Workers] Mark Custom Branch Aliases as supported in Pages compatibility matrix - #34178

Merged
irvinebroque merged 1 commit into
cloudflare:productionfrom
neelakolkar-cf:issue-22709-workers-preview-custom-domains
Oct 10, 2026
Merged

irvinebroque merged 1 commit into
cloudflare:productionfrom
neelakolkar-cf:issue-22709-workers-preview-custom-domains

Conversation

@neelakolkar-cf

Copy link
Copy Markdown
Contributor

Closes #22709

Summary

Updates the "Custom Branch Aliases" row in the Pages to Workers compatibility matrix from ⏳ (coming soon) to ✅ for Workers. Adds a footnote that links to custom domain Preview URLs and explains how they differ from Pages branch aliases.

Why

Worker Previews (changelog 2026-09-22) can serve Preview URLs on a custom domain, at <preview-name>.<your-domain>. The Preview name defaults to the Git branch. This covers the use case in #22709: branch previews on your own domain, for example to share cookies with production. The matrix still listed the feature as coming soon.

It is not exactly the same as Pages, so the footnote explains the difference. Pages lets you point any hostname at a branch. Workers uses <preview-name>.<domain> with a wildcard DNS record and certificate.

Note on footnote numbering

The site's Markdown renderer (remark-gfm) numbers footnotes in the order they are referenced, not by their labels. The new reference comes before the existing [^5] and [^6], so those are renamed to [^6] and [^7]. The hardcoded "As in 5" in the Pages Plugins footnote is updated to 6 so it still points to the File-based Routing footnote. The footnote wording is unchanged. I rendered the section with remark-gfm to confirm the footnotes appear as 1–7 in order.

Documentation checklist

  • Is there a changelog entry (guidelines)? Not needed. Worker Previews already has a changelog entry.
  • The change adheres to the documentation style guide.

@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Oct 10, 2026 •

Copy link
Copy Markdown
Contributor

AI Review

✅ Reviewed 1e40f04 · 0 findings · incremental

Commands
  • /review Run a review now.
  • /full-review Review the entire PR diff.
  • /disable-auto-review Stop automatic reviews.
  • /rebase Rebase against production.

@irvinebroque
irvinebroque enabled auto-merge (squash) October 10, 2026 16:48
@irvinebroque
irvinebroque merged commit 99e5acc into cloudflare:production Oct 10, 2026
11 checks passed
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.

"Pages to Workers" compatibility matrix is missing "Add a custom domain to a branch" feature

2 participants