releases.shpreview

New DO namespaces must use SQLite; KV backend blocked for new accounts

1 enhancementThis release1 enhancementImprovements to existing featuresAI-tallied from the release notes
From the original release noteView original ↗

If your account does not already have a key-value (KV) backed Durable Object namespace, you can no longer create new ones. New Durable Object namespaces must use the SQLite storage backend, which has been recommended for all new Durable Objects since it became generally available in 2024.

Create a new class with a new_sqlite_classes migration:

  • wrangler.jsonc

    <div><div><span>{</span></div></div><div><div><span>  </span><span>"</span><span>$schema</span><span>"</span><span>:</span><span> </span><span>"./node_modules/wrangler/config-schema.json"</span><span>,</span></div></div><div><div><span>  </span><span>"</span><span>migrations</span><span>"</span><span>:</span><span> </span><span>[</span></div></div><div><div><span>    </span><span>{</span></div></div><div><div><span>      </span><span>"</span><span>tag</span><span>"</span><span>:</span><span> </span><span>"v1"</span><span>,</span></div></div><div><div><span>      </span><span>"</span><span>new_sqlite_classes</span><span>"</span><span>:</span><span> </span><span>[</span></div></div><div><div><span>        </span><span>"MyDurableObject"</span></div></div><div><div><span>      </span><span>]</span></div></div><div><div><span>    </span><span>}</span></div></div><div><div><span>  </span><span>]</span></div></div><div><div><span>}</span></div></div>
  • wrangler.toml

    <div><div><span>[[</span><span>migrations</span><span>]]</span></div></div><div><div><span>tag</span><span> </span><span>=</span><span> </span><span>"v1"</span></div></div><div><div><span>new_sqlite_classes</span><span> </span><span>=</span><span> </span><span>[</span><span>"MyDurableObject"</span><span>]</span></div></div>

SQLite-backed Durable Objects have feature parity with the key-value backend — including the key-value storage API — and additionally support relational SQL queries and point-in-time recovery to restore an object's storage to any point in the past 30 days.

If you attempt to create a new key-value backed namespace (a new_classes migration) on an affected account, the deployment fails with the following error:

<div><div><span>Creating new key-value backed Durable Object namespaces is no longer supported on this account. Please create a namespace using a `new_sqlite_classes` migration instead.</span></div></div>

This change only affects accounts that are not already using the key-value storage backend. Accounts with at least one existing key-value backed namespace can still create new ones for now, and the Workers Free plan has only ever supported SQLite-backed Durable Objects. It is part of a broader move toward SQLite as the single storage backend for Durable Objects, ahead of a future migration path for existing key-value backed objects.

For more information, refer to Durable Objects migrations.

Fetched July 10, 2026