Skip to content

Commit 72b05ce

Browse files
authored
Update 2025-10-23-preview-url-default-behavior.mdx
1 parent d34aa6f commit 72b05ce

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

src/content/changelog/workers/2025-10-23-preview-url-default-behavior.mdx

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -15,15 +15,17 @@ This change is intended to provide a more intuitive and secure experience by ali
1515
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).
1616

1717
**Wrangler Version Behavior**
18+
1819
The default behavior depends on the version of Wrangler you are using. This new logic applies to the latest version. Here is a summary of the behavior across different versions:
19-
- Before v4.34.0: Preview URLs defaulted to enabled, regardless of the workers.dev setting.
20-
- v4.34.0 up to the latest version: Preview URLs defaulted to disabled, regardless of the workers.dev setting.
21-
- Latest version: Preview URLs now default to matching your workers.dev setting.
20+
- **Before v4.34.0:** Preview URLs defaulted to enabled, regardless of the workers.dev setting.
21+
- **v4.34.0 up to the latest version:** Preview URLs defaulted to disabled, regardless of the workers.dev setting.
22+
- **Latest version:** Preview URLs now default to matching your workers.dev setting.
2223

2324
**Why we’re making this change**
24-
In July, we introduced preview URLs to Workers, which let you preview code changes before deploying to production. This made disabling your Worker’s workers.dev URL an ambiguous action — the preview URL, served as a subdomain of `workers.dev` (ex: `preview-id-worker-name.account-name.workers.dev`) would still be live even if you had disabled your Worker’s `workers.dev` route. If you misinterpreted what it meant to disable your `workers.dev` route, you might unintentionally leave preview URLs enabled when you didn’t mean to, and expose them to the public Internet.
2525

26-
To address this, we made a one-time update to disable preview URLs on existing Workers that had their workers.dev route disabled and changed the default behavior to be disabled for all new deployments where a preview URL setting was not explicitly configured.
26+
In July, [we introduced preview URLs to Workers](/changelog/2025-07-23-workers-preview-urls/), which let you preview code changes before deploying to production. This made disabling your Worker’s workers.dev URL an ambiguous action — the preview URL, served as a subdomain of `workers.dev` (ex: `preview-id-worker-name.account-name.workers.dev`) would still be live even if you had disabled your Worker’s `workers.dev` route. If you misinterpreted what it meant to disable your `workers.dev` route, you might unintentionally leave preview URLs enabled when you didn’t mean to, and expose them to the public Internet.
27+
28+
To address this, we made a [one-time update](/changelog/2025-09-17-update-preview-url-setting/) to disable preview URLs on existing Workers that had their workers.dev route disabled and changed the default behavior to be disabled for all new deployments where a preview URL setting was not explicitly configured.
2729

2830
While this change helped secure many customers, it was also disruptive for customers who keep their `workers.dev` route enabled and actively use the preview functionality, as it now required them to explicitly enable preview URLs on every redeployment.
2931
T

0 commit comments

Comments
 (0)