Skip to content

Commit 3a39358

Browse files
dinasaur404WalshyDevGregBrimbleelithrar
authored
Create 2025-09-17-update-preview-url-setting.mdx (cloudflare#25236)
* Create 2025-09-17-update-preview-url-setting.mdx * Update src/content/changelog/workers/2025-09-17-update-preview-url-setting.mdx Co-authored-by: Daniel Walsh <[email protected]> * Update src/content/changelog/workers/2025-09-17-update-preview-url-setting.mdx Co-authored-by: Daniel Walsh <[email protected]> * Update 2025-09-17-update-preview-url-setting.mdx * Update 2025-09-17-update-preview-url-setting.mdx * Update 2025-09-17-update-preview-url-setting.mdx * Update 2025-09-17-update-preview-url-setting.mdx * Update src/content/changelog/workers/2025-09-17-update-preview-url-setting.mdx Co-authored-by: Greg Brimble <[email protected]> * Update src/content/changelog/workers/2025-09-17-update-preview-url-setting.mdx Co-authored-by: Matt Silverlock <[email protected]> * Update 2025-09-17-update-preview-url-setting.mdx * Update src/content/changelog/workers/2025-09-17-update-preview-url-setting.mdx Co-authored-by: Greg Brimble <[email protected]> * Update 2025-09-17-update-preview-url-setting.mdx * Update 2025-09-17-update-preview-url-setting.mdx * Update 2025-09-17-update-preview-url-setting.mdx --------- Co-authored-by: Daniel Walsh <[email protected]> Co-authored-by: Greg Brimble <[email protected]> Co-authored-by: Matt Silverlock <[email protected]>
1 parent 8dd8342 commit 3a39358

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
title: Preview URLs now default to opt-in
3+
description: We performed a one-time update to disable preview URLs on Workers with workers.dev disabled to require an explicit opt-in.
4+
date: 2025-09-17
5+
---
6+
import { WranglerConfig, Aside } from "~/components";
7+
8+
To prevent the accidental exposure of applications, we've updated how [Worker preview URLs](/workers/configuration/previews/) (`<PREVIEW>-<WORKER_NAME>.<SUBDOMAIN>.workers.dev`) are handled. We made this change to ensure preview URLs are only active when intentionally configured, improving the default security posture of your Workers.
9+
10+
## One-Time Update for Workers with workers.dev Disabled
11+
We performed a one-time update to disable preview URLs for existing Workers where the [workers.dev subdomain](/workers/configuration/routing/workers-dev/) was also disabled.
12+
13+
Because preview URLs were historically enabled by default, users who had intentionally disabled their workers.dev route may not have realized their Worker was still accessible at a separate preview URL. This update was performed to ensure that using a preview URL is always an intentional, opt-in choice.
14+
15+
If your Worker was affected, its preview URL (`<PREVIEW>-<WORKER_NAME>.<SUBDOMAIN>.workers.dev`) will now direct to an informational page explaining this change.
16+
17+
**How to Re-enable Your Preview URL**
18+
19+
If your preview URL was disabled, you can re-enable it [via the Cloudflare dashboard](/workers/configuration/previews/#toggle-preview-urls-enable-or-disable) by navigating to your Worker's Settings page and toggling on the Preview URL.
20+
21+
Alternatively, you can use Wrangler by adding the `preview_urls = true` setting to your Wrangler file and redeploying the Worker.
22+
23+
<WranglerConfig>
24+
```jsonc title="wrangler.jsonc"
25+
{
26+
"preview_urls": true
27+
}
28+
```
29+
</WranglerConfig>
30+
31+
**Note:** You can set `preview_urls = true` with any Wrangler version that supports the preview URL flag (v3.91.0+). However, we recommend updating to v4.34.0 or newer, as this version defaults `preview_urls` to false, ensuring preview URLs are always enabled by explicit choice.

0 commit comments

Comments
 (0)