{
  "slug": "wrangler-versions-deploy-accepts-version-tag-16440f51b1a7",
  "title": "wrangler versions deploy accepts --version-tag",
  "tools": [
    "wrangler"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-06-09T12:48:28.000Z",
  "announced_at": "2026-06-09T12:48:28.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "If you need to deploy or roll back a Worker version by its upload tag, run `wrangler versions deploy --version-tag <sha>@100%`. Tags resolve against deployable versions; if a tag is missing or ambiguous, or the version is no longer deployable, use its Version ID instead.",
    "examples": [
      "wrangler versions deploy --version-tag <sha>@100%"
    ],
    "gotchas": [
      "Version: 4.99.0",
      "--version-tag <tag> (required): Worker Version tag to deploy; resolves to a Version ID among deployable versions. Accepts `<tag>@<percentage>` shorthand.",
      "Prerequisite: Use Wrangler 4.99.0 or later for `--version-tag` support.",
      "Prerequisite: Wrangler versions commands require Wrangler 3.40.0 or later; versions before 3.73.0 require `--x-versions`.",
      "Tags resolve only against recent deployable versions.",
      "If a tag matches no deployable version or matches more than one, the command errors and asks you to deploy by Version ID directly.",
      "Older versions that have aged out of the deployable window must be deployed by Version ID."
    ]
  },
  "why_it_matters": "Roll out or roll back a Worker version identified by its upload tag.",
  "before": "Look up the version ID first, then deploy using that ID.",
  "sources": [
    "https://github.com/cloudflare/workers-sdk/releases/tag/wrangler%404.99.0",
    "https://developers.cloudflare.com/workers/wrangler/commands/workers/"
  ],
  "rank": 0.98049,
  "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": "backfill-20261007",
    "verdict_id": "backfill-20261007:backfill-20261007-412ae260f94e092e-2:gate",
    "evidence_hash": "3ae058449663e4a41e368e6a31a0862679c6371306476b68201bdf7af384922d"
  },
  "review": {
    "draft_hash": "0d047595eb5d82722ba287fecf7cea51f84e1543fd0fdb04a1a0d742304af4b7",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "backfill-20261007:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.98 >= 0.9; 2 needed) and Jev gave 0.80 (>= 0.6 needed)."
  }
}