{
  "slug": "wrangler-deploy-versions-deploy-and-rollback-support-durable-objects-code-update-015fcabdb0be",
  "title": "wrangler deploy, versions deploy, and rollback support Durable Objects code update strategies",
  "tools": [
    "wrangler"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-09-25T19:33:53.000Z",
  "announced_at": "2026-09-25T19:33:53.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When deploying or rolling back a Worker with Durable Objects, set the code update mode to control when their code updates. Use `--durable-objects-code-update-mode immediate` for immediate updates, or `deferred <delay>` to set the maximum delay; the Wrangler config field could not be verified in the official docs found.",
    "examples": [
      "npx wrangler versions deploy <VERSION-SPECS> --durable-objects-code-update-mode immediate",
      "wrangler rollback [<VERSION_ID>] --durable-objects-code-update-mode deferred 30s",
      "wrangler deploy --durable-objects-code-update-mode deferred 30s"
    ],
    "gotchas": [
      "Version: 4.141.0",
      "--durable-objects-code-update-mode: Selects Durable Object code update behavior; docs say `immediate` or `deferred` followed by a maximum delay, such as `deferred 30s`.",
      "Prerequisite: Wrangler versions commands require Wrangler 3.40.0 or later; Wrangler 4.141.0 exceeds that minimum.",
      "When unset, the strategy defaults to deferred with a 5-minute maximum delay.",
      "Delays cannot exceed 24 hours and must use millisecond precision."
    ]
  },
  "why_it_matters": "When deploying or rolling back a Worker with Durable Objects, configure when its code updates.",
  "sources": [
    "https://github.com/cloudflare/workers-sdk/releases/tag/wrangler%404.141.0",
    "https://developers.cloudflare.com/workers/wrangler/commands/workers/"
  ],
  "rank": 0.97048,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v1+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "gap-20261007",
    "verdict_id": "gap-20261007:gap-20261007-79989fec27d9ada8-0:gate",
    "evidence_hash": "85c232f114ca9ba8b20d17843dbaac795e6a7f11e58234026138f2c4148902bd"
  },
  "review": {
    "draft_hash": "ea3a5cb664826a59c13a606275beff2f2c3f9db0edc6779b64b60576b692146d",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "gap-20261007:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.97 >= 0.9; 2 needed) and Jev gave 0.78 (>= 0.6 needed)."
  }
}