Workflows created on or after September 10, 2026, on the Workers Paid plan retain completed and errored instance state for seven days by default (previously 30 days). The seven day default helps to reduce storage costs by default. The maximum retention limit remains 30 days.
The retention period for existing Workflows is unchanged. The Workers Free plan retains its three-day default and limit.
To set the retention period for a Workflow instance, specify successRetention, errorRetention, or both:
const instance = await env.MY_WORKFLOW.create({
retention: {
successRetention: "2 days",
errorRetention: "30 days",
},
});
const instance = await env.MY_WORKFLOW.create({
retention: {
successRetention: "2 days",
errorRetention: "30 days",
},
});
You can also set the retention period per Workflow and per instance in the Cloudflare dashboard ↗.
For retention details, refer to Workflows pricing and the WorkflowInstanceCreateOptions API reference.
Source: Cloudflare


