[Workflows] Updated retention period

Author: mia303

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:
+
+<TypeScriptExample>
+
+```ts
+const instance = await env.MY_WORKFLOW.create({
+	retention: {
+		successRetention: "1 day",
+		errorRetention: "7 days",
+	},
+});
+```
+
+</TypeScriptExample>
+
+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).