Skip to content

Commit 0702089

Browse files
authored
Create 2025-10-23-preview-url-default-behavior
1 parent 0222acd commit 0702089

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
---
2+
title: Workers Preview URL default behavior now matches your workers.dev setting
3+
description: If a Workers Preview URL setting is not explicitly configured, its default behavior will now match the setting of the workers.dev subdomain.
4+
date: 2025-10-23
5+
---
6+
We have updated the default behavior for Cloudflare Workers [Preview URLs](/workers/configuration/previews/). Going forward, if a preview URL setting is not [explicitly configured](/workers/configuration/previews/#toggle-preview-urls-enable-or-disable) during deployment, its default behavior will automatically match the setting of your `[workers.dev` subdomain](/workers/configuration/routing/workers-dev/).
7+
8+
This change is intended to provide a more intuitive and secure experience by aligning your preview URL's default state with your `workers.dev` configuration to prevent cases where a preview URL might remain public even after you disabled your `workers.dev` route.
9+
10+
Here is how the new default logic works:
11+
12+
- If your `workers.dev` route is enabled (or not configured) and no preview URL is set, Preview URLs will default to enabled.
13+
14+
- If your `workers.dev` route is disabled and no preview URL is set, Preview URLs will default to disabled.
15+
16+
You can override the default setting by explicitly enabling or disabling the preview URL in your Worker's configuration through the [API](/api/resources/workers/subresources/scripts/subresources/subdomain/), [Dashboard](/workers/configuration/previews/#from-the-dashboard), or [Wrangler](/workers/configuration/previews/#from-the-wrangler-configuration-file). This new logic applies when deploying with the latest version of Wrangler.
17+
18+
To further secure your `workers.dev` subdomain and preview URL, you can [enable Cloudflare Access with a single click](/changelog/2025-10-03-one-click-access-for-workers/) in your Worker's settings to limit access to specific users or groups.

0 commit comments

Comments
 (0)