[wrangler] Make unavailable Preview URL guidance actionable

[yomna-shousha]

PR #15336 added the original note when a Preview deployment has no active URLs. That note says to enable Preview Deployments, but it does not name the configuration fields or explain that Wrangler must first deploy the route or Workers.dev setting.

This updates the shared message used by wrangler preview and Preview secret commands. It tells users to set top-level preview_urls for Workers.dev previews or route-level previews_enabled for custom-domain previews, run wrangler deploy, and then run wrangler preview again. The existing custom-domain Preview documentation link remains in the message.

The URL checks and API behavior are unchanged. Tests cover both URL arrays being empty, either array containing an active URL, and active URLs returned by Preview secret commands.

---

• Tests
  • Tests included/updated
  • Automated tests not possible - manual testing has been completed as follows:
  • Additional testing not necessary because:
• Public documentation
  • Cloudflare docs PR(s):
  • Documentation not necessary because: This change makes existing Wrangler guidance actionable and retains the existing documentation link.

A picture of a cute animal (not mandatory, but encouraged)

Note

This is a contribution from an AI agent: OpenCode, GPT-5.6 Sol.

[changeset-bot]

🦋 Changeset detected

Latest commit: 53e5fbe

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 3 packages

Name	Type
wrangler	Patch
@cloudflare/vite-plugin	Patch
@cloudflare/vitest-plugin	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[pkg-pr-new]

@cloudflare/autoconfig

npm i https://pkg.pr.new/@cloudflare/autoconfig@15524

@cloudflare/build-output-utils

npm i https://pkg.pr.new/@cloudflare/build-output-utils@15524

@cloudflare/codemods

npm i https://pkg.pr.new/@cloudflare/codemods@15524

@cloudflare/config

npm i https://pkg.pr.new/@cloudflare/config@15524

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@15524

@cloudflare/deploy-helpers

npm i https://pkg.pr.new/@cloudflare/deploy-helpers@15524

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@15524

miniflare

npm i https://pkg.pr.new/miniflare@15524

@cloudflare/pages-functions

npm i https://pkg.pr.new/@cloudflare/pages-functions@15524

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@15524

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@15524

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@15524

@cloudflare/vitest-plugin

npm i https://pkg.pr.new/@cloudflare/vitest-plugin@15524

@cloudflare/workers-auth

npm i https://pkg.pr.new/@cloudflare/workers-auth@15524

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@15524

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@15524

wrangler

npm i https://pkg.pr.new/wrangler@15524

commit: 53e5fbe