[metadata]
algolia_content_type: Concept
algolia_product_filter: Workers
description: Understand how Workers tracks changes with versions and releases them with deployments.
generator: Astro v7.2.0
generator: Nimbus v0.2.2
image: https://developers.cloudflare.com/og-docs.png
og:description: Understand how Workers tracks changes with versions and releases them with deployments.
og:image: https://developers.cloudflare.com/og-docs.png
og:locale: en
og:site_name: Cloudflare Docs
og:title: Versions & deployments
og:title: Versions & deployments · Cloudflare Workers docs
og:type: article
og:url: https://developers.cloudflare.com/workers/versions-and-deployments/
pcx_additional_products: Workers
pcx_content_group: Developer platform
pcx_content_type: Concept
pcx_last_modified: 45
pcx_product: Workers
twitter:card: summary_large_image
twitter:image: https://developers.cloudflare.com/og-docs.png
twitter:site: @cloudflare
viewport: width=device-width, initial-scale=1

[canonical-links]
https://developers.cloudflare.com/workers/versions-and-deployments/

[document-links]
/
1. Migrate webpack projects: /workers/wrangler/migration/v1-to-v2/eject-webpack/
2. Update to Wrangler v2: /workers/wrangler/migration/v1-to-v2/update-v1-to-v2/
AI Security: https://www.cloudflare.com/solutions/ai-security/
AI ↗: /workers-ai/get-started/workers-wrangler/#2-connect-your-worker-to-workers-ai
API: /api/
API: /workers/vite-plugin/reference/api/
API: /workers/wrangler/api/
APIs: /workers/configuration/integrations/apis/
About: https://www.cloudflare.com/about/
Adding local data: /workers/local-development/local-data/
Advanced setups: /workers/ci-cd/builds/advanced-setups/
Agent setup ↗: /agent-setup/
Agent setup: /agent-setup/
Agents SDK ↗: /agents/
Alarm Handler ↗: /durable-objects/api/alarms/
Analog: /workers/framework-guides/web-apps/more-web-frameworks/analog/
Analytics Engine ↗: /analytics/analytics-engine/
Angular: /workers/framework-guides/web-apps/more-web-frameworks/angular/
App innovation report: https://www.cloudflare.com/resource/app-innovation-report/
Artifacts: /workers/wrangler/commands/artifacts/
Assets ↗: /workers/static-assets/binding/
Astro: /workers/framework-guides/web-apps/astro/
AsyncLocalStorage: /workers/runtime-apis/nodejs/asynclocalstorage/
Athenian Project: https://www.cloudflare.com/athenian/
Attaching a Debugger: /workers/testing/miniflare/developing/debugger/
Authentication profiles: /workers/wrangler/profiles/
Authentication: /workers/wrangler/migration/v1-to-v2/wrangler-legacy/authentication/
Automatic pull requests: /workers/ci-cd/builds/automatic-prs/
Betas: /workers/platform/betas/
Billing and Limitations: /workers/static-assets/billing-and-limitations/
Bindings ↗: /workers/runtime-apis/bindings/
Blog: https://blog.cloudflare.com/
Breakpoints: /workers/observability/dev-tools/breakpoints/
Browser Run ↗: /browser-run/
Browser: /workers/wrangler/commands/browser/
Buffer: /workers/runtime-apis/nodejs/buffer/
Build an Interactive ChatGPT App: /workers/demos/chatgpt-app/
Build branches: /workers/ci-cd/builds/build-branches/
Build caching: /workers/ci-cd/builds/build-caching/
Build image: /workers/ci-cd/builds/build-image/
Build watch paths: /workers/ci-cd/builds/build-watch-paths/
Builds API reference: /workers/ci-cd/builds/api-reference/
Built with Cloudflare button: /workers/platform/built-with-cloudflare/
Bundling: /workers/wrangler/bundling/
CLI: /workers/get-started/guide/
Cache keys: /workers/cache/cache-keys/
Cache: /workers/runtime-apis/cache/
Cache: /workers/testing/miniflare/storage/cache/
Careers: https://www.cloudflare.com/careers/
Case studies: https://www.cloudflare.com/case-studies/
Certificates: /workers/wrangler/commands/certificates/
Changelog: /changelog/
Choose a data or storage product: /workers/platform/storage-options/
Choosing between Wrangler & Vite: /workers/local-development/wrangler-vs-vite/
Claim deployments (temporary accounts): /workers/platform/claim-deployments/
Cloudflare AI Cloud: https://www.cloudflare.com/solutions/ai/
Cloudflare Access: /workers/configuration/cloudflare-access/
Cloudflare D1 ↗: /d1/
Cloudflare Docs llms-full.txt ↗: /llms-full.txt
Cloudflare Docs llms.txt ↗: /llms.txt
Cloudflare Environments: /workers/vite-plugin/reference/cloudflare-environments/
Cloudflare Radar: https://radar.cloudflare.com/
Cloudflare Skills ↗: https://github.com/cloudflare/skills
Cloudflare for Campaigns: https://www.cloudflare.com/campaigns/
Code Mode MCP Server ↗: https://github.com/cloudflare/mcp
Commands: /workers/wrangler/migration/v1-to-v2/wrangler-legacy/commands/
Community: https://community.cloudflare.com/
Compatibility Dates: /workers/testing/miniflare/core/compatibility/
Compatibility dates: /workers/configuration/compatibility-dates/
Compatibility flags: /workers/configuration/compatibility-flags/
Compliance resources: https://www.cloudflare.com/trust-hub/compliance-resources/
Configuration and Bindings: /workers/static-assets/binding/
Configuration: /workers/cache/configuration/
Configuration: /workers/ci-cd/builds/configuration/
Configuration: /workers/testing/vitest-integration/configuration/
Configuration: /workers/wrangler/configuration/
Configuration: /workers/wrangler/migration/v1-to-v2/wrangler-legacy/configuration/
Configure the test harness: /workers/testing/test-harness/configure/
Connect to databases: /workers/databases/connecting-to-databases/
Console: /workers/runtime-apis/console/
Contact sales: https://www.cloudflare.com/resource/contact-enterprise-sales/
Containers: /workers/wrangler/commands/containers/
Context (ctx): /workers/runtime-apis/context/
Cron Triggers: /workers/configuration/cron-triggers/
Custom Domains: /workers/configuration/routing/custom-domains/
Custom builds: /workers/wrangler/custom-builds/
Custom spans Beta: /workers/observability/traces/custom-spans/
D1 ↗: /d1/worker-api/
D1: /d1/
D1: /workers/testing/miniflare/storage/d1/
D1: /workers/wrangler/commands/d1/
Dashboard: /workers/get-started/dashboard/
Data Protection: https://www.cloudflare.com/trust-hub/gdpr/
Debugging: /workers/cache/debugging/
Debugging: /workers/testing/vitest-integration/debugging/
Debugging: /workers/vite-plugin/reference/debugging/
Deploy Hooks: /workers/ci-cd/builds/deploy-hooks/
Deploy an existing project: /workers/framework-guides/automatic-configuration/
Deploy to Cloudflare buttons: /workers/platform/deploy-buttons/
Deployment management: /workers/versions-and-deployments/deployment-management/
Deprecations: /workers/wrangler/deprecations/
Developing with multiple Workers: /workers/local-development/multi-workers/
Diagnostics Channel: /workers/runtime-apis/nodejs/diagnostics-channel/
Direct Uploads: /workers/static-assets/direct-upload/
Directory: /directory/
Dispatcher (Workers for Platforms) ↗: /cloudflare-for-platforms/workers-for-platforms/configuration/dynamic-dispatch/
Docs: /
Documentation: https://developers.cloudflare.com/
Docusaurus: /workers/framework-guides/web-apps/more-web-frameworks/docusaurus/
Domain name search: https://domains.cloudflare.com/
Domain-specific MCP Servers ↗ MCP: https://github.com/cloudflare/mcp-server-cloudflare
Durable Objects ↗: /durable-objects/api/
Durable Objects: /durable-objects/
Durable Objects: /workers/testing/miniflare/storage/durable-objects/
Dynamic Worker Loaders: /workers/runtime-apis/bindings/worker-loader/
Edit page: https://github.com/cloudflare/cloudflare-docs/edit/production/src/content/docs/workers/versions-and-deployments/index.mdx
Email Handler ↗: /email-service/api/route-emails/email-handler/
Encoding: /workers/runtime-apis/encoding/
Environment Variables ↗: /workers/configuration/environment-variables/
Environment variables and secrets: /workers/local-development/environment-variables/
Environment variables: /workers/configuration/environment-variables/
Environments: /workers/wrangler/environments/
Error handling: /workers/runtime-apis/rpc/error-handling/
Errors and exceptions: /workers/observability/errors/
Event subscriptions: /workers/ci-cd/builds/event-subscriptions/
EventEmitter: /workers/runtime-apis/nodejs/eventemitter/
EventSource: /workers/runtime-apis/eventsource/
Events: https://www.cloudflare.com/events/
Examples ↗: /workers/examples/?languages=JavaScript
Examples ↗: /workers/examples/?languages=TypeScript
Examples: /workers/cache/examples/
Examples: /workers/examples/
Examples: /workers/languages/python/examples/
Expo: https://docs.expo.dev/eas/hosting/reference/worker-runtime/
Export to Axiom: /workers/observability/exporting-opentelemetry-data/axiom/
Export to Grafana Cloud: /workers/observability/exporting-opentelemetry-data/grafana-cloud/
Export to Honeycomb: /workers/observability/exporting-opentelemetry-data/honeycomb/
Export to PostHog: /workers/observability/exporting-opentelemetry-data/posthog/
Export to Sentry: /workers/observability/exporting-opentelemetry-data/sentry/
External Services: /workers/configuration/integrations/external-services/
FastAPI ↗: /workers/languages/python/packages/fastapi/
FastAPI: /workers/languages/python/packages/fastapi/
Fetch Events: /workers/testing/miniflare/core/fetch/
Fetch Handler: /workers/runtime-apis/handlers/fetch/
Fetch: /workers/runtime-apis/fetch/
Find a partner: https://partnerlocator.cloudflare.com/dashboard
Flagship: /workers/wrangler/commands/flagship/
Foreign Function Interface (FFI): /workers/languages/python/ffi/
Frontend Development Platform: https://www.cloudflare.com/solutions/frontends/
Full-stack application: /workers/static-assets/routing/full-stack-application/
Gatsby: /workers/framework-guides/web-apps/more-web-frameworks/gatsby/
General commands: /workers/wrangler/commands/general/
Get Started: /workers/static-assets/get-started/
Get Started: /workers/testing/miniflare/get-started/
Get started: /workers/testing/test-harness/get-started/
Get started: /workers/vite-plugin/get-started/
GitHub Actions: /workers/ci-cd/external-cicd/github-actions/
GitHub integration: /workers/ci-cd/builds/git-integration/github-integration/
GitLab CI/CD: /workers/ci-cd/external-cicd/gitlab-cicd/
GitLab integration: /workers/ci-cd/builds/git-integration/gitlab-integration/
Global network: https://www.cloudflare.com/network/
Glossary: /workers/glossary/
Go to Workers & Pages ↗: https://dash.cloudflare.com/?to=/:account/workers-and-pages
Gradual deployments: /workers/versions-and-deployments/gradual-deployments/
Gradual rollouts ↗: /workers/versions-and-deployments/gradual-deployments/version-affinity/#static-assets
HTML handling: /workers/static-assets/routing/advanced/html-handling/
HTMLRewriter: /workers/runtime-apis/html-rewriter/
HTTP: /workers/runtime-apis/bindings/service-bindings/http/
Headers: /workers/runtime-apis/headers/
Headers: /workers/static-assets/headers/
Home: /
Hono ↗: /workers/framework-guides/web-apps/more-web-frameworks/hono/
Hono: /workers/framework-guides/web-apps/more-web-frameworks/hono/
How Python Workers Work: /workers/languages/python/how-python-workers-work/
How Workers works: /workers/reference/how-workers-works/
How the Cache works: /workers/reference/how-the-cache-works/
Hyperdrive ↗: /hyperdrive/
Hyperdrive: /workers/wrangler/commands/hyperdrive/
Images ↗: /images/optimization/binding/
Impact/ESG: https://www.cloudflare.com/impact/
Infrastructure as Code (IaC): /workers/platform/infrastructure-as-code/
Install / Update: /workers/wrangler/migration/v1-to-v2/wrangler-legacy/install-update/
Install/Update Wrangler: /workers/wrangler/install-and-update/
Integrations: /workers/testing/test-harness/integrations/
Interact with Workers: /workers/testing/test-harness/interact-with-workers/
Investors: https://cloudflare.net/
Isolation and concurrency: /workers/testing/vitest-integration/isolation-and-concurrency/
KV ↗: /kv/api/
KV: /kv/
KV: /workers/testing/miniflare/storage/kv/
KV: /workers/wrangler/commands/kv/
Known issues: /workers/platform/known-issues/
Known issues: /workers/testing/vitest-integration/known-issues/
Known limitations: /workers/observability/traces/known-limitations/
LangChain ↗: /workers/languages/python/packages/langchain/
Langchain: /workers/languages/python/packages/langchain/
Learning center: https://www.cloudflare.com/learning/
Lifecycle: /workers/runtime-apis/rpc/lifecycle/
Limitations: /workers/cache/limitations/
Limits & pricing: /workers/ci-cd/builds/limits-and-pricing/
Limits: /workers/platform/limits/
Live Reload: /workers/testing/miniflare/developing/live-reload/
Local Explorer: /workers/local-development/local-explorer/
Log In: https://dash.cloudflare.com/login
Log in: https://dash.cloudflare.com/
MCP server MCP: https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/workers-builds
MCP server MCP: https://github.com/cloudflare/mcp-server-cloudflare/tree/main/apps/workers-observability
Media Transformations ↗: /stream/transform-videos/bindings/
MessageChannel: /workers/runtime-apis/messagechannel/
Metrics and analytics: /workers/observability/metrics-and-analytics/
Microfrontends: /workers/framework-guides/web-apps/microfrontends/
Migrate from Miniflare 2's test environments: /workers/testing/vitest-integration/migration-guides/migrate-from-miniflare-2/
Migrate from Netlify to Workers: /workers/static-assets/migration-guides/netlify-to-workers/
Migrate from Pages to Workers: /workers/static-assets/migration-guides/migrate-from-pages/
Migrate from Service Workers to ES Modules: /workers/reference/migrate-to-module-workers/
Migrate from Vercel to Workers: /workers/static-assets/migration-guides/vercel-to-workers/
Migrate from Vitest 3 to Vitest 4: /workers/testing/vitest-integration/migration-guides/migrate-from-vitest-3-to-vitest-4/
Migrate from Wrangler v2 to v3: /workers/wrangler/migration/update-v2-to-v3/
Migrate from Wrangler v3 to v4: /workers/wrangler/migration/update-v3-to-v4/
Migrate from unstable_dev: /workers/testing/vitest-integration/migration-guides/migrate-from-unstable-dev/
Migrating from Version 2: /workers/testing/miniflare/migrations/from-v2/
Migrating from wrangler dev: /workers/vite-plugin/reference/migrating-from-wrangler-dev/
Modules: /workers/testing/miniflare/core/modules/
Multi-Tenant Platform Development: https://www.cloudflare.com/solutions/platforms/
Multipart upload metadata: /workers/configuration/multipart-upload-metadata/
Multiple Workers: /workers/testing/miniflare/core/multiple-workers/
Neon: /workers/databases/third-party-integrations/neon/
Next Deployment management: /workers/versions-and-deployments/deployment-management/
Next.js: /workers/framework-guides/web-apps/nextjs/
Non-JavaScript modules: /workers/vite-plugin/reference/non-javascript-modules/
Nuxt: /workers/framework-guides/web-apps/more-web-frameworks/nuxt/
Overview: /workers/
Overview: /workers/cache/
Overview: /workers/ci-cd/
Overview: /workers/ci-cd/builds/
Overview: /workers/ci-cd/builds/git-integration/
Overview: /workers/ci-cd/external-cicd/
Overview: /workers/configuration/
Overview: /workers/configuration/integrations/
Overview: /workers/configuration/routing/
Overview: /workers/configuration/sites/
Overview: /workers/databases/third-party-integrations/
Overview: /workers/demos/
Overview: /workers/languages/
Overview: /workers/languages/javascript/
Overview: /workers/languages/python/
Overview: /workers/languages/python/packages/
Overview: /workers/languages/rust/
Overview: /workers/languages/typescript/
Overview: /workers/local-development/
Overview: /workers/observability/
Overview: /workers/observability/dev-tools/
Overview: /workers/observability/exporting-opentelemetry-data/
Overview: /workers/observability/logs/
Overview: /workers/observability/traces/
Overview: /workers/platform/
Overview: /workers/platform/changelog/
Overview: /workers/runtime-apis/
Overview: /workers/runtime-apis/bindings/
Overview: /workers/runtime-apis/bindings/service-bindings/
Overview: /workers/runtime-apis/handlers/
Overview: /workers/runtime-apis/nodejs/
Overview: /workers/runtime-apis/rpc/
Overview: /workers/runtime-apis/streams/
Overview: /workers/runtime-apis/webassembly/
Overview: /workers/static-assets/
Overview: /workers/testing/
Overview: /workers/testing/miniflare/
Overview: /workers/testing/test-harness/
Overview: /workers/testing/vitest-integration/
Overview: /workers/versions-and-deployments/
Overview: /workers/versions-and-deployments/gradual-deployments/
Overview: /workers/vite-plugin/
Overview: /workers/wrangler/
Overview: /workers/wrangler/commands/
Overview: /workers/wrangler/migration/v1-to-v2/wrangler-legacy/
Page Rules: /workers/configuration/workers-with-page-rules/
Pages: /workers/wrangler/commands/pages/
Partners: https://www.cloudflare.com/partners/
Performance and timers: /workers/runtime-apis/performance/
Pipelines: /workers/wrangler/commands/pipelines/
Placement Beta: /workers/configuration/placement/
PlanetScale: /workers/databases/third-party-integrations/planetscale/
Plans: https://www.cloudflare.com/plans/
Playground: /workers/playground/
Prepare test state: /workers/testing/test-harness/prepare-test-state/
Press kit: https://www.cloudflare.com/press/press-kit/
Press: https://www.cloudflare.com/press/
Preview URLs: /workers/versions-and-deployments/preview-urls/
Previous Secrets: /workers/configuration/secrets/
Pricing: /workers/platform/pricing/
Privacy policy: https://www.cloudflare.com/policies/privacy/
Profiling CPU usage: /workers/observability/dev-tools/cpu-usage/
Profiling Memory: /workers/observability/dev-tools/memory-usage/
Programmatic configuration: /workers/vite-plugin/reference/programmatic-configuration/
Project Fairshot: https://www.cloudflare.com/fair-shot/
Project Galileo: https://www.cloudflare.com/galileo/
Prompting: /workers/get-started/prompting/
Protocols: /workers/reference/protocols/
Purging the cache: /workers/cache/purge/
Query Builder: /workers/observability/query-builder/
Queue Handler ↗: /queues/configuration/javascript-apis/#consumer
Queues ↗: /queues/configuration/javascript-apis/
Queues: /workers/testing/miniflare/core/queues/
Queues: /workers/wrangler/commands/queues/
Qwik: /workers/framework-guides/web-apps/more-web-frameworks/qwik/
R2 ↗: /r2/api/workers/workers-api-reference/
R2: /r2/
R2: /workers/testing/miniflare/storage/r2/
R2: /workers/wrangler/commands/r2/
RPC (WorkerEntrypoint): /workers/runtime-apis/bindings/service-bindings/rpc/
Rate Limiting: /workers/runtime-apis/bindings/rate-limit/
React + Vite: /workers/framework-guides/web-apps/react/
React Router (formerly Remix): /workers/framework-guides/web-apps/react-router/
ReadableStream BYOBReader: /workers/runtime-apis/streams/readablestreambyobreader/
ReadableStream DefaultReader: /workers/runtime-apis/streams/readablestreamdefaultreader/
ReadableStream: /workers/runtime-apis/streams/readablestream/
Real-time logs: /workers/observability/logs/real-time-logs/
Recipes and examples: /workers/testing/vitest-integration/recipes/
Redirects: /workers/static-assets/redirects/
RedwoodSDK: /workers/framework-guides/web-apps/redwoodsdk/
Report abuse: https://www.cloudflare.com/trust-hub/abuse-approach/
Report issue: https://github.com/cloudflare/cloudflare-docs/issues/new/choose
Report security issues: https://www.cloudflare.com/disclosure/
Request: /workers/runtime-apis/request/
Reserved Methods: /workers/runtime-apis/rpc/reserved-methods/
Response: /workers/runtime-apis/response/
Responsible AI: https://www.cloudflare.com/trust-hub/responsible-ai/
Rollbacks: /workers/versions-and-deployments/rollbacks/
Routes: /workers/configuration/routing/routes/
SDKs: /fundamentals/api/reference/sdks/
SSE and SASE platform: https://www.cloudflare.com/sase/
Scheduled Events: /workers/testing/miniflare/core/scheduled/
Scheduled Handler: /workers/runtime-apis/handlers/scheduled/
Scheduler: /workers/runtime-apis/scheduler/
Secrets Store ↗ Beta: /secrets-store/integrations/workers/
Secrets Store: /workers/wrangler/commands/secrets-store/
Secrets ↗: /workers/configuration/secrets/
Secrets: /workers/configuration/secrets/
Secrets: /workers/vite-plugin/reference/secrets/
Security model: /workers/reference/security-model/
Sentry: https://docs.sentry.io/platforms/javascript/guides/cloudflare/
Serving a subdirectory: /workers/static-assets/routing/advanced/serving-a-subdirectory/
Share a local dev server: /workers/local-development/local-dev-tunnels/
Single Page Application (SPA): /workers/static-assets/routing/single-page-application/
Solid Beta: /workers/framework-guides/web-apps/more-web-frameworks/solid/
Source maps and stack traces: /workers/observability/source-maps/
Spans and attributes: /workers/observability/traces/spans-and-attributes/
Standard Library: /workers/languages/python/stdlib/
Start Building: https://dash.cloudflare.com/sign-up
Start from Worker: /workers/configuration/sites/start-from-worker/
Start from existing: /workers/configuration/sites/start-from-existing/
Start from scratch: /workers/configuration/sites/start-from-scratch/
Startups: https://www.cloudflare.com/startups/
Static Assets: /workers/vite-plugin/reference/static-assets/
Static Site Generation (SSG) and custom 404 pages: /workers/static-assets/routing/static-site-generation/
Status: https://www.cloudflarestatus.com/
Stream ↗: /stream/manage-video-library/bindings/
Streams: /workers/runtime-apis/nodejs/streams/
StringDecoder: /workers/runtime-apis/nodejs/string-decoder/
Supabase: /workers/databases/third-party-integrations/supabase/
Support: https://support.cloudflare.com/
Supported bindings per development mode: /workers/local-development/bindings-per-env/
Supported crates: /workers/languages/rust/crates/
SvelteKit: /workers/framework-guides/web-apps/sveltekit/
System environment variables: /workers/wrangler/system-environment-variables/
TCP sockets: /workers/runtime-apis/tcp-sockets/
Tail Handler: /workers/runtime-apis/handlers/tail/
Tail Workers: /workers/observability/logs/tail-workers/
TanStack Start: /workers/framework-guides/web-apps/tanstack-start/
Templates: /workers/get-started/quickstarts/
Terms of use: https://www.cloudflare.com/policies/terms/
Test APIs: /workers/testing/vitest-integration/test-apis/
The Basics: /workers/languages/python/basics/
Trademark: https://www.cloudflare.com/trademark/
TransformStream: /workers/runtime-apis/streams/transformstream/
Transparency report: https://www.cloudflare.com/transparency/
Troubleshooting builds: /workers/ci-cd/builds/troubleshoot/
Trust Hub: https://www.cloudflare.com/trust-hub/
Tunnel: /workers/wrangler/commands/tunnel/
Turso: /workers/databases/third-party-integrations/turso/
Tutorial - React SPA with an API: /workers/vite-plugin/tutorial/
Tutorials: /workers/tutorials/
TypeScript: /workers/runtime-apis/rpc/typescript/
Under attack?: https://www.cloudflare.com/under-attack-hotline/
Upstash: /workers/databases/third-party-integrations/upstash/
VPC: /workers/wrangler/commands/vpc/
Variables and Secrets: /workers/testing/miniflare/core/variables-secrets/
Vectorize (vector database) ↗: /vectorize/
Vectorize ↗: /vectorize/reference/client-api/
Vectorize: /workers/wrangler/commands/vectorize/
Version affinity: /workers/versions-and-deployments/gradual-deployments/version-affinity/
Version metadata Beta: /workers/runtime-apis/bindings/version-metadata/
Version overrides: /workers/versions-and-deployments/version-overrides/
View as Markdown: index.md
Vike: /workers/framework-guides/web-apps/vike/
Visibility and Security Model: /workers/runtime-apis/rpc/visibility/
Vite Environments: /workers/vite-plugin/reference/vite-environments/
Vite Plugin ↗: /workers/vite-plugin/
Vue: /workers/framework-guides/web-apps/vue/
Waku: /workers/framework-guides/web-apps/more-web-frameworks/waku/
Wasm in JavaScript: /workers/runtime-apis/webassembly/javascript/
Web Crypto: /workers/runtime-apis/web-crypto/
Web Security Platform: https://www.cloudflare.com/solutions/security/
Web Standards: /workers/testing/miniflare/core/standards/
Web standards: /workers/runtime-apis/web-standards/
WebSockets: /workers/runtime-apis/websockets/
WebSockets: /workers/testing/miniflare/core/web-sockets/
Webpack: /workers/wrangler/migration/v1-to-v2/wrangler-legacy/webpack/
With Durable Objects: /workers/versions-and-deployments/gradual-deployments/with-durable-objects/
Worker script: /workers/static-assets/routing/worker-script/
Workers (Historic): /workers/platform/changelog/historical-changelog/
Workers Best Practices: /workers/best-practices/workers-best-practices/
Workers Logpush: /workers/observability/logs/logpush/
Workers Logs: /workers/observability/logs/workers-logs/
Workers Sites configuration: /workers/configuration/sites/configuration/
Workers for Platforms ↗: /cloudflare-for-platforms/workers-for-platforms/
Workers for Platforms: /workers/wrangler/commands/workers-for-platforms/
Workers llms-full.txt ↗: /workers/llms-full.txt
Workers llms.txt ↗: /workers/llms.txt
Workers: /workers/
Workers: /workers/wrangler/commands/workers/
Workflows ↗: /workflows/
Workflows: /workers/wrangler/commands/workflows/
Wrangler's unstable_startWorker(): /workers/testing/unstable_startworker/
Wrangler: https://github.com/cloudflare/workers-sdk/releases
WritableStream DefaultWriter: /workers/runtime-apis/streams/writablestreamdefaultwriter/
WritableStream: /workers/runtime-apis/streams/writablestream/
Write your first test: /workers/testing/vitest-integration/write-your-first-test/
Writing tests: /workers/testing/miniflare/writing-tests/
Xata: /workers/databases/third-party-integrations/xata/
assert: /workers/runtime-apis/nodejs/assert/
bindings: /workers/runtime-apis/bindings/
bundled code: /workers/wrangler/bundling/
compatibility settings: /workers/configuration/compatibility-dates/
crypto: /workers/runtime-apis/nodejs/crypto/
deployments list: /workers/wrangler/commands/workers/#deployments-list
dns: /workers/runtime-apis/nodejs/dns/
fs: /workers/runtime-apis/nodejs/fs/
gradual deployment: /workers/versions-and-deployments/gradual-deployments/
gradual deployments: /workers/versions-and-deployments/gradual-deployments/
http: /workers/runtime-apis/nodejs/http/
https: /workers/runtime-apis/nodejs/https/
https://github.com/cloudflare/cloudflare-docs
mTLS: /workers/runtime-apis/bindings/mtls/
net: /workers/runtime-apis/nodejs/net/
path: /workers/runtime-apis/nodejs/path/
process: /workers/runtime-apis/nodejs/process/
static assets: /workers/static-assets/
storage resources: /workers/platform/storage-options/
test: /workers/runtime-apis/nodejs/test/
timers: /workers/runtime-apis/nodejs/timers/
tls: /workers/runtime-apis/nodejs/tls/
url: /workers/runtime-apis/nodejs/url/
util: /workers/runtime-apis/nodejs/util/
versions list: /workers/wrangler/commands/workers/#versions-list
workers.dev: /workers/configuration/routing/workers-dev/
wrangler deploy: /workers/wrangler/commands/workers/#deploy
zlib: /workers/runtime-apis/nodejs/zlib/

[structured-data]
{"@context":"https://schema.org","@id":"https://developers.cloudflare.com/workers/versions-and-deployments/#page","@type":"TechArticle","dateModified":"2026-07-03","description":"Understand how Workers tracks changes with versions and releases them with deployments.","headline":"Versions & deployments · Cloudflare Workers docs","image":"https://developers.cloudflare.com/og-docs.png","inLanguage":"en","isPartOf":{"@id":"https://developers.cloudflare.com/#website","@type":"WebSite","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"},"publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"url":"https://developers.cloudflare.com/workers/versions-and-deployments/"}

[content]
Versions & deployments · Cloudflare Workers docs
Skip to content
Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt
Use this file to discover all available pages before exploring further.
Docs
Directory
API
SDKs
Changelog
Search
Ctrl
K
Log in
Workers
/
Overview
Getting started
CLI
Dashboard
Prompting
Templates
Examples
Tutorials
Best practices
Workers Best Practices
Demos and architectures
Overview
Build an Interactive ChatGPT App
Local development
Overview
Environment variables and secrets
Vite Plugin ↗
Choosing between Wrangler & Vite
Developing with multiple Workers
Adding local data
Supported bindings per development mode
Local Explorer
Share a local dev server
Playground
Configuration
Overview
Workers Sites
Overview
Start from existing
Start from scratch
Start from Worker
Workers Sites configuration
Bindings ↗
Cloudflare Access
Compatibility dates
Compatibility flags
Cron Triggers
Environment variables
Integrations
Overview
APIs
External Services
Multipart upload metadata
Page Rules
Placement
Beta
Routes and domains
Overview
Custom Domains
Routes
workers.dev
Secrets
Versions & deployments
Overview
Deployment management
Preview URLs
Gradual deployments
Overview
Version affinity
With Durable Objects
Version overrides
Rollbacks
CI/CD
Overview
Builds
Overview
Configuration
Automatic pull requests
Git integration
Overview
GitHub integration
GitLab integration
Build image
Build caching
Build branches
Build watch paths
Deploy Hooks
Advanced setups
Event subscriptions
Troubleshooting builds
Builds API reference
Limits & pricing
MCP server
MCP
External CI/CD
Overview
GitHub Actions
GitLab CI/CD
Workers Cache
Overview
Configuration
Cache keys
Purging the cache
Examples
Debugging
Limitations
Runtime APIs
Overview
Remote-procedure call (RPC)
Overview
Lifecycle
Reserved Methods
Visibility and Security Model
TypeScript
Error handling
WebAssembly (Wasm)
Overview
Wasm in JavaScript
Bindings (env)
Overview
AI ↗
Analytics Engine ↗
Assets ↗
Browser Run ↗
D1 ↗
Dispatcher (Workers for Platforms) ↗
Durable Objects ↗
Dynamic Worker Loaders
Environment Variables ↗
Hyperdrive ↗
Images ↗
KV ↗
Media Transformations ↗
mTLS
Queues ↗
R2 ↗
Rate Limiting
Secrets ↗
Secrets Store ↗
Beta
Service bindings
Overview
HTTP
RPC (WorkerEntrypoint)
Stream ↗
Vectorize ↗
Version metadata
Beta
Workflows ↗
Cache
Console
Context (ctx)
Encoding
EventSource
Fetch
Handlers
Overview
Alarm Handler ↗
Email Handler ↗
Fetch Handler
Queue Handler ↗
Scheduled Handler
Tail Handler
Headers
HTMLRewriter
MessageChannel
Node.js compatibility
Overview
assert
AsyncLocalStorage
Buffer
crypto
Diagnostics Channel
dns
EventEmitter
fs
http
https
net
path
process
Streams
StringDecoder
test
timers
tls
url
util
zlib
Performance and timers
Request
Response
Scheduler
Streams
Overview
ReadableStream
ReadableStream BYOBReader
ReadableStream DefaultReader
TransformStream
WritableStream
WritableStream DefaultWriter
TCP sockets
Web Crypto
Web standards
WebSockets
Static Assets
Overview
Get Started
Configuration and Bindings
Routing
Full-stack application
Single Page Application (SPA)
Static Site Generation (SSG) and custom 404 pages
Worker script
Advanced
Gradual rollouts ↗
HTML handling
Serving a subdirectory
Headers
Redirects
Direct Uploads
Billing and Limitations
Migration Guides
Migrate from Pages to Workers
Migrate from Netlify to Workers
Migrate from Vercel to Workers
Framework guides
Deploy an existing project
Web applications
React + Vite
Astro
React Router (formerly Remix)
Next.js
Vue
RedwoodSDK
TanStack Start
Microfrontends
SvelteKit
Vike
More guides...
Analog
Angular
Docusaurus
Gatsby
Hono
Nuxt
Qwik
Solid
Beta
Waku
Mobile applications
Expo
APIs
FastAPI ↗
Hono ↗
AI & agents
Agents SDK ↗
LangChain ↗
Databases
Connect to databases
Analytics Engine ↗
Vectorize (vector database) ↗
Cloudflare D1 ↗
Hyperdrive ↗
3rd Party Integrations
Overview
Neon
PlanetScale
Supabase
Turso
Upstash
Xata
Observability
Overview
Metrics and analytics
Logs
Overview
Workers Logs
Real-time logs
Tail Workers
Workers Logpush
Traces
Beta
Overview
Custom spans
Beta
Spans and attributes
Known limitations
DevTools
Overview
Breakpoints
Profiling CPU usage
Profiling Memory
Query Builder
Exporting OpenTelemetry Data
Overview
Export to Honeycomb
Export to Grafana Cloud
Export to Axiom
Export to Sentry
Export to PostHog
MCP server
MCP
Errors and exceptions
Integrations
Sentry
Source maps and stack traces
Testing
Overview
Vitest integration
Overview
Write your first test
Recipes and examples
Configuration
Test APIs
Isolation and concurrency
Debugging
Known issues
Migration guides
Migrate from Vitest 3 to Vitest 4
Migrate from Miniflare 2's test environments
Migrate from unstable_dev
Integration test harness
Overview
Get started
Configure the test harness
Prepare test state
Interact with Workers
Integrations
Miniflare
Overview
Get Started
Writing tests
Core
Compatibility Dates
Fetch Events
Modules
Multiple Workers
Queues
Scheduled Events
Variables and Secrets
Web Standards
WebSockets
Developing
Attaching a Debugger
Live Reload
Migrations
Migrating from Version 2
Storage
Cache
D1
Durable Objects
KV
R2
Wrangler's unstable_startWorker()
Wrangler
Overview
Install/Update Wrangler
Migrations
Migrate from Wrangler v3 to v4
Migrate from Wrangler v2 to v3
Migrate from Wrangler v1 to v2
Wrangler v1 (legacy)
Overview
Install / Update
Authentication
Commands
Configuration
Webpack
1. Migrate webpack projects
2. Update to Wrangler v2
API
Commands
Overview
Workers
General commands
Artifacts
Browser
Certificates
Containers
D1
Flagship
Hyperdrive
KV
Pages
Pipelines
Queues
R2
Secrets Store
Tunnel
Vectorize
VPC
Workers for Platforms
Workflows
Authentication profiles
Bundling
Configuration
Custom builds
Deprecations
Environments
System environment variables
Vite plugin
Overview
Get started
Tutorial - React SPA with an API
Reference
API
Static Assets
Debugging
Migrating from wrangler dev
Secrets
Vite Environments
Cloudflare Environments
Non-JavaScript modules
Programmatic configuration
Languages
Overview
JavaScript
Overview
Examples ↗
TypeScript
Overview
Examples ↗
Python Workers
Beta
Overview
The Basics
How Python Workers Work
Foreign Function Interface (FFI)
Standard Library
Examples
Packages
Overview
FastAPI
Langchain
Rust
Beta
Overview
Supported crates
Platform
Overview
Pricing
Changelog
Overview
Workers (Historic)
Wrangler
Limits
Choose a data or storage product
Betas
Deploy to Cloudflare buttons
Claim deployments (temporary accounts)
Built with Cloudflare button
Known issues
Workers for Platforms ↗
Infrastructure as Code (IaC)
Glossary
Reference
How the Cache works
How Workers works
Migrate from Service Workers to ES Modules
Protocols
Security model
Agent resources
Agent setup ↗
Cloudflare Skills ↗
Code Mode MCP Server ↗
Domain-specific MCP Servers ↗
MCP
Workers llms.txt ↗
Workers llms-full.txt ↗
Cloudflare Docs llms.txt ↗
Cloudflare Docs llms-full.txt ↗
Home
/
Workers
/
Versions & deployments
Versions & deployments
Last updated
Jul 3, 2026
|
Copy as Markdown
|
View as Markdown
|
Agent setup
Overview
Versions
Deployments
Default behavior
View versions and deployments
Via Wrangler
Via the Cloudflare dashboard
Next steps
Every time you change your Worker's code or configuration, Workers creates a
version
. A
deployment
determines which version(s) are actively serving traffic.
Versions
A version captures the complete state of your Worker at a point in time: its
bundled code
,
static assets
,
bindings
, and
compatibility settings
. Each version has a unique ID and tracks who created it, when, and from where.
You can optionally attach a message and tag to a version when you upload it.
Note
State changes for associated
storage resources
such as
KV
,
R2
,
Durable Objects
, and
D1
are not tracked with versions.
Deployments
A deployment determines which version(s) of your Worker are actively serving traffic. A deployment can reference one version (serving 100% of traffic) or two versions (with traffic split between them during a
gradual deployment
).
Each deployment tracks who created it, when, and which version(s) it includes.
Default behavior
By default, these two concepts are coupled together - when you run
wrangler deploy
, Workers creates a new version and immediately deploys it to 100% of traffic in a single step.
You can decouple them so that uploading a version and deploying it are independent actions. This gives you control over when new code goes live, and lets you use strategies like
gradual deployments
or manual promotion. Refer to
Deployment management
for details.
View versions and deployments
Via Wrangler
Wrangler allows you to view the 100 most recent versions and deployments. Refer to the
versions list
and
deployments list
documentation for the commands.
Via the Cloudflare dashboard
In the Cloudflare dashboard, go to the
Workers & Pages
page.
Go to
Workers & Pages
↗
Select your Worker >
Deployments
.
Next steps
Deployment management
- Upload versions without deploying them and control when they go live
Preview URLs
- Test new versions before deploying them to production
Gradual deployments
- Split traffic between two versions using percentage-based routing
Version affinity
- Consistently route users to the same version across page loads during a gradual deployment
Version overrides
- Send a request to a specific version by ID for smoke testing and pinning between Workers
Rollbacks
- Revert to a previously deployed version
Previous
Secrets
Next
Deployment management
Was this helpful?
Yes
No
Edit page
Report issue
On this page
Overview
Versions
Deployments
Default behavior
View versions and deployments
Via Wrangler
Via the Cloudflare dashboard
Next steps
Edit page
Report issue
Getting started
Plans
Contact sales
Partners
Find a partner
Startups
Under attack?
Domain name search
Company
About
Careers
Investors
Press
Press kit
Global network
Public interest
Project Galileo
Athenian Project
Cloudflare for Campaigns
Project Fairshot
Impact/ESG
Compliance
Compliance resources
Trust Hub
Data Protection
Responsible AI
Transparency report
Report abuse
Resources
App innovation report
Cloudflare Radar
Case studies
Status
Support
Events
Blog
Developers
Documentation
Learning center
Community
Solutions
SSE and SASE platform
Cloudflare AI Cloud
AI Security
Frontend Development Platform
Multi-Tenant Platform Development
Web Security Platform
Start Building
Log In
© 2026 Cloudflare, Inc.
Privacy policy
|
Report security issues
|
Terms of use
|
Trademark
|
Your privacy choices
Docs
