You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
title: "Stable branch-based preview aliases now available for Cloudflare Workers"
3
-
description: "Automatic preview aliases for Worker deployments, enabling improved preview flows and pull request collaboration"
2
+
title: "Test your code changes instantly with automatic preview URLs for Cloudflare Workers"
3
+
description: "Get shareable preview links for every code change, making it easier to test and collaborate before going live"
4
4
products:
5
5
- workers
6
-
date: "2025-07-16T01:00:00Z"
6
+
date: 2025-07-22T01:00:00Z
7
7
---
8
8
9
-
We are introducing **automatic preview aliases for Cloudflare Workers**, now available in public beta.
9
+
We are introducing automatic aliased preview URLs for Cloudflare Workers, now available in public beta.
10
10
11
-
Just like in Pages, each pull request now includes a comment with a **stable, aliased preview URL** based on the branch name. The URL stays the same with every commit and always points to the latest version of that branch, making it easier to test, share, and collaborate on changes.
12
-
13
-
This is another step toward bringing full feature parity between Pages and Workers.
14
-
15
-
## How it works
16
-
17
-
When you create a pull request:
18
-
19
-
-**A preview alias is automatically created** based on the Git branch name (e.g., `<branch-name>` becomes `<branch-name>-<worker-name>.<subdomain>.workers.dev`)
20
-
-**No configuration is needed**, the alias is generated for you
21
-
-**Preview URLs are posted directly to PR comments** just like in Pages
11
+
What this means: Just like Pages, every time you make code changes and create a pull request, you'll automatically get a shareable preview link where you can see your changes running, without affecting production.
12
+
These preview URLs are named after your branch and are posted as a comment to each pull request. The URL stays the same with every commit and always points to the latest version of that branch.
22
13
23
14

24
15
@@ -29,6 +20,15 @@ Each PR comment includes **two preview URLs** as shown above:
29
20
***Commit Preview URL**: Unique to the specific version/commit (e.g., `<version-prefix>-<worker-name>.<subdomain>.workers.dev`)
30
21
***Branch Preview URL**: A stable alias based on the branch name (e.g., `<branch-name>-<worker-name>.<subdomain>.workers.dev`)
31
22
23
+
## How it works
24
+
25
+
When you create a pull request:
26
+
27
+
-**A preview alias is automatically created** based on the Git branch name (e.g., `<branch-name>` becomes `<branch-name>-<worker-name>.<subdomain>.workers.dev`)
28
+
-**No configuration is needed**, the alias is generated for you
29
+
-**The link stays the same** even as you make more commits
30
+
-**Preview URLs are posted directly to PR comments** just like in Pages
31
+
32
32
## Custom alias name
33
33
34
34
You can still assign a custom preview alias using the Wrangler CLI:
* Not generated for Workers that use **Durable Objects**
46
46
* Not yet supported for **Workers for Platforms**
47
47
48
-
We are actively refining the experience. Stay tuned as we continue expanding preview and collaboration workflows.
48
+
This brings Workers in line with our Pages platform, where preview URLs have been highly useful for developer workflows. Stay tuned as we continue expanding preview and collaboration workflows on Workers.
0 commit comments