Versions & deployments

Last updated Sep 22, 2026 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 and Deployments

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

  1. In the Cloudflare dashboard, go to the Workers & Pages page. Go to Workers & Pages ↗
  2. Select your Worker > Deployments.

Next steps

  • Deployment management - Upload versions without deploying them and control when they go live
  • Version 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

Was this helpful?

YesNo

On this page

Versions & deployments - 图2Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/versions-and-deployments/#page","headline":"Versions & deployments","description":"Understand how Workers tracks changes with versions and releases them with deployments.","url":"https://developers.cloudflare.com/workers/versions-and-deployments/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/versions-and-deployments/og.png?v=ed23c8daadd08946","dateModified":"2026-09-22","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Upload versions independently and control when and how they are deployed to your Worker's traffic. title: Deployment management image: https://developers.cloudflare.com/workers/versions-and-deployments/deployment-management/og.png?v=45414a68701c50de

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.