{
  "slug": "wrangler-workflows-configures-per-instance-step-limits-89879eff68c2",
  "title": "wrangler Workflows configures per-instance step limits",
  "tools": [
    "wrangler"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-03-03T21:50:34.000Z",
  "announced_at": "2026-03-03T21:50:34.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When a Workflow needs a per-instance step cap, set `workflows[].limits.steps` to an integer from 1 to 25,000; the default is 10,000. Run `wrangler dev` to enforce the configured limit locally.",
    "examples": [
      "{\n  \"workflows\": [{\n    \"name\": \"<workflow-name>\",\n    \"binding\": \"<binding-name>\",\n    \"class_name\": \"<class-name>\",\n    \"limits\": { \"steps\": 5000 }\n  }]\n}"
    ],
    "gotchas": [
      "Version: 4.70.0",
      "workflows[].limits.steps: Maximum steps per Workflow instance; integer from 1 to 25,000. Defaults to 10,000 when omitted.",
      "workflows[].name (required): Workflow name.",
      "workflows[].binding (required): Binding name used to access the Workflow.",
      "workflows[].class_name (required): Workflow class name.",
      "Prerequisite: The configurable 10,000–25,000 step limit applies to Workflows on Workers Paid; Workers Free has a 1,024-step limit.",
      "The `steps` value must be an integer between 1 and 25,000.",
      "The default limit is 10,000 steps when not specified.",
      "Docs conflict: The current general Wrangler configuration page says limits are enforced only when deployed, while the Wrangler 4.70.0 release note specifically says Workflow step limits are enforced by `wrangler dev` locally. https://developers.cloudflare.com/workers/wrangler/configuration/"
    ]
  },
  "why_it_matters": "Set a maximum step count for a Workflow instance and reproduce that limit in local development.",
  "before": "Instances were limited to 1,024 steps.",
  "sources": [
    "https://github.com/cloudflare/workers-sdk/releases/tag/wrangler%404.70.0",
    "https://developers.cloudflare.com/changelog/post/2026-03-03-step-limits-to-25k/",
    "https://developers.cloudflare.com/workers/wrangler/configuration/",
    "https://developers.cloudflare.com/workflows/build/workers-api/"
  ],
  "rank": 0.94029,
  "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-1563e00f63b688f3-5:gate",
    "evidence_hash": "466d88208f30055fac260a830134b81c67385aa8695f145eead52bc09f8c3478"
  },
  "review": {
    "draft_hash": "721a2e856fb972f3c597459c1bc1d34ecabf5d162ff0eb334a6e9831f540c195",
    "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.94 >= 0.9; 2 needed) and Jev gave 0.78 (>= 0.6 needed)."
  }
}