cloudflare · Cloudflare Workers Docs
Workers Preview URLs
Explains how to use versioned and aliased preview URLs to test Worker versions in live environments without affecting production deployments, including methods for accessing them via Wrangler or the Cloudflare dashboard.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Workers Preview URLs
Explains how to use versioned and aliased preview URLs to test Worker versions in live environments without affecting production deployments, including methods for accessing them via Wrangler or the Cloudflare dashboard.
When To Use
Use when you need to preview new Worker versions in a live environment, set up CI/CD preview environments, or create human-readable aliases for specific deployments.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/workers-configuration-previews-preview-urls-workflow-guide.md | Documentation explaining the types and management of versioned and aliased preview URLs for Cloudflare Workers. | Questions about documentation explaining the types and management of versioned and aliased preview URLs for Cloudflare Workers. |
examples/workers-configuration-previews-preview-urls-cloudflare-workers-wrangler-.text | A text command demonstrating how to use the wrangler versions upload flag to set a preview alias for Cloudflare Workers. | Exact payloads, commands, or snippets shown in A text command demonstrating how to use the wrangler versions upload flag to set a preview alias for Cloudflare Workers. |
examples/workers-configuration-previews-preview-urls-cloudflare-workers-configura.text | A configuration snippet demonstrating how to enable preview URLs within a Cloudflare Workers configuration file. | Exact payloads, commands, or snippets shown in A configuration snippet demonstrating how to enable preview URLs within a Cloudflare Workers configuration file. |
examples/workers-configuration-previews-preview-urls-cloudflare-workers-preview-u.text | A text configuration example demonstrating how to enable preview URLs in a Cloudflare Workers configuration file. | Exact payloads, commands, or snippets shown in A text configuration example demonstrating how to enable preview URLs in a Cloudflare Workers configuration file. |
examples/workers-configuration-previews-preview-urls-cloudflare-workers-preview-u-2.text | A configuration snippet demonstrating how to enable or disable preview URLs in a Cloudflare Workers wrangler configuration file. | Exact payloads, commands, or snippets shown in A configuration snippet demonstrating how to enable or disable preview URLs in a Cloudflare Workers wrangler configur... |
examples/workers-configuration-previews-preview-urls-cloudflare-workers-preview-u-3.text | A text example demonstrating how to configure the preview_urls setting within a Cloudflare Workers configuration file. | Exact payloads, commands, or snippets shown in A text example demonstrating how to configure the previewurls setting within a Cloudflare Workers configuration file. |
What This Skill Covers
- Preview URLs allow you to preview new versions of your Worker without deploying it to production.
- Main sections:
Types of Preview URLs,Versioned Preview URLs,View versioned preview URLs using Wrangler,View versioned preview URLs on the Workers dashboard,Aliased preview URLs.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.cloudflare.com/workers/configuration/previews