Workflows - Default instance retention for new Workflows on Workers Paid is seven days
- Announced
- Tags
- Workflows
- Severity
- info, set by
reef/rss-rule-v1 - Source
- https://developers.cloudflare.com/changelog/post/2026-09-10-paid-retention-default/
<p><a href="https://developers.cloudflare.com/workflows/">Workflows</a> 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 <a href="https://developers.cloudflare.com/workflows/reference/limits/">limit</a> remains 30 days.</p> <p>The retention period for existing Workflows is unchanged. The Workers Free plan retains its three-day default and limit.</p> <p>To set the retention period for a Workflow instance, specify <code>successRetention</code>, <code>errorRetention</code>, or both:</p> <div><div data-nb-tabs data-nb-sync-key="workersExamples" class><div class="relative flex border-b border-border" role="tablist" data-nb-tabs-list><span class="bg-primary pointer-events-none absolute -bottom-px h-0.5 rounded-t-sm transition-[left,width] duration-200 ease-out" data-nb-tabs-indicator aria-hidden="true"></span></div><div class="mt-3"><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="JavaScript" class><figure class="nb-code-figure" data-nb-lang="js"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="js" data-nb-lang="js"><code><span class="line"><span class="nb-shiki-1itgoe">const</span><span class="nb-shiki-dzsirb"> instance</span><span class="nb-shiki-1itgoe"> =</span><span class="nb-shiki-1itgoe"> await</span><span class="nb-shiki-140thh"> env.</span><span class="nb-shiki-dzsirb">MY_WORKFLOW</span><span class="nb-shiki-140thh">.</span><span class="nb-shiki-1t8gfj">create</span><span class="nb-shiki-140thh">({</span></span> <span class="line"><span class="nb-shiki-140thh"> retention: {</span></span> <span class="line"><span class="nb-shiki-140thh"> successRetention: </span><span class="nb-shiki-mdbnqw">"2 days"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-140thh"> errorRetention: </span><span class="nb-shiki-mdbnqw">"30 days"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-140thh"> },</span></span> <span class="line"><span class="nb-shiki-140thh">});</span></span></code></pre></figure></div><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="TypeScript" class><figure class="nb-code-figure" data-nb-lang="ts"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="ts" data-nb-lang="ts"><code><span class="line"><span class="nb-shiki-1itgoe">const</span><span class="nb-shiki-dzsirb"> instance</span><span class="nb-shiki-1itgoe"> =</span><span class="nb-shiki-1itgoe"> await</span><span class="nb-shiki-140thh"> env.</span><span class="nb-shiki-dzsirb">MY_WORKFLOW</span><span class="nb-shiki-140thh">.</span><span class="nb-shiki-1t8gfj">create</span><span class="nb-shiki-140thh">({</span></span> <span class="line"><span class="nb-shiki-140thh"> retention: {</span></span> <span class="line"><span class="nb-shiki-140thh"> successRetention: </span><span class="nb-shiki-mdbnqw">"2 days"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-140thh"> errorRetention: </span><span class="nb-shiki-mdbnqw">"30 days"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-140thh"> },</span></span> <span class="line"><span class="nb-shiki-140thh">});</span></span></code></pre></figure></div></div></div><script type="module" src="https://developers.cloudflare.com/home/runner/work/cloudflare-docs/cloudflare-docs/src/components/ui/tabs/Tabs.astro?astro&type=script&index=0&lang.ts"></script></div> <p>You can also set the retention period per Workflow and per instance in the <a href="https://dash.cloudflare.com/?to=/:account/workers/workflows" target="_blank" rel="noopener">Cloudflare dashboard<span class="external-link"> ↗︎</span></a>.</p> <p>For retention details, refer to <a href="https://developers.cloudflare.com/workflows/reference/pricing/">Workflows pricing</a> and the <a href="https://developers.cloudflare.com/workflows/build/workers-api/#workflowinstancecreateoptions"><code>WorkflowInstanceCreateOptions</code> API reference</a>.</p>
The text above is the source's. reef added the severity, the dates it could read from the text, and the endpoints and scopes named in code.