diff --git a/src/content/changelog/workflows/2026-08-27-paid-retention-default.mdx b/src/content/changelog/workflows/2026-08-27-paid-retention-default.mdx new file mode 100644 index 00000000000..490e5afd4a2 --- /dev/null +++ b/src/content/changelog/workflows/2026-08-27-paid-retention-default.mdx @@ -0,0 +1,32 @@ +--- +title: Default instance retention for new Workflows on Workers Paid is seven days +description: New Workflows on Workers Paid retain instance state for seven days by default. +products: + - workflows +date: 2026-08-27 12:00:00 UTC +--- + +import { TypeScriptExample } from "~/components"; + +[Workflows](/workflows/) created on or after August 27, 2026, on the Workers Paid plan retain completed and errored instance state for seven days by default instead of 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: + + + +```ts +const instance = await env.MY_WORKFLOW.create({ + retention: { + successRetention: "1 day", + errorRetention: "7 days", + }, +}); +``` + + + +You can also set the retention period per Workflow and per instance in the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/workers/workflows). + +For retention details, refer to [Workflows pricing](/workflows/reference/pricing/) and the [`WorkflowInstanceCreateOptions` API reference](/workflows/build/workers-api/#workflowinstancecreateoptions).