Changelog | Durable Objects

Durable Objects - Declarative class lifecycle with `exports`

Tue, 30 Jun 2026 00:00:00 GMT

A new declarative exports field in your Wrangler configuration file replaces the imperative migrations array for creating, deleting, renaming, and transferring Durable Object classes. Each wrangler deploy now prints a structured reconciliation report. Existing Workers on migrations continue to work unchanged.

Durable Objects - Billing for SQLite Storage

Wed, 07 Jan 2026 00:00:00 GMT

Storage billing for SQLite-backed Durable Objects will be enabled in January 2026, with a target date of January 7, 2026 (no earlier). For more details, refer to the Billing for SQLite Storage.

Durable Objects - 2025-10-25

Sat, 25 Oct 2025 00:00:00 GMT

The maximum WebSocket message size limit has been increased from 1 MiB to 32 MiB.

Durable Objects - Durable Objects can access stored data with UI editor

Thu, 16 Oct 2025 00:00:00 GMT

Durable Objects stored data can be viewed and written using Data Studio on the Cloudflare dashboard. Only Durable Objects using SQLite storage can use Data Studio.

Durable Objects - Durable Objects stubs can now be directly constructed by name

Thu, 21 Aug 2025 00:00:00 GMT

A DurableObjectStub can now be directly constructed by created directly with DurableObjectNamespace::getByName.

Durable Objects - Durable Objects on Workers Free plan

Mon, 07 Apr 2025 00:00:00 GMT

SQLite-backed Durable Objects are now available on the Workers Free plan with these limits.

Durable Objects - SQLite in Durable Objects GA

Mon, 07 Apr 2025 00:00:00 GMT

SQLite-backed Durable Objects and corresponding Storage API methods like sql.exec have moved from beta to general availability. New Durable Object classes should use wrangler configuration for SQLite storage over key-value storage.

SQLite storage per Durable Object has increased to 10GB for all existing and new objects.

Durable Objects - 2025-02-19

Wed, 19 Feb 2025 00:00:00 GMT

SQLite-backed Durable Objects now support PRAGMA optimize command, which can improve database query performance. It is recommended to run this command after a schema change (for example, after creating an index). Refer to PRAGMA optimize for more information.

Durable Objects - 2025-02-11

Tue, 11 Feb 2025 00:00:00 GMT

When Durable Objects generate an "internal error" exception in response to certain failures, the exception message may provide a reference ID that customers can include in support communication for easier error identification. For example, an exception with the new message might look like: internal error; reference = 0123456789abcdefghijklmn.

Durable Objects - Alarms re-enabled in (beta) SQLite-backed Durable Object classes

Mon, 07 Oct 2024 00:00:00 GMT

The issue identified with alarms in beta Durable Object classes with a SQLite storage backend has been resolved and alarms have been re-enabled.

Durable Objects - Alarms disabled in (beta) SQLite-backed Durable Object classes

Fri, 27 Sep 2024 00:00:00 GMT

An issue was identified with alarms in beta Durable Object classes with a SQLite storage backend. Alarms have been temporarily disabled for only SQLite-backed Durable Objects while a fix is implemented. Alarms in Durable Objects with default, key-value storage backend are unaffected and continue to operate.

Durable Objects - (Beta) SQLite storage backend & SQL API available on new Durable Object classes

Thu, 26 Sep 2024 00:00:00 GMT

The new beta version of Durable Objects is available where each Durable Object has a private, embedded SQLite database. When deploying a new Durable Object class, users can opt-in to a SQLite storage backend in order to access new SQL API and point-in-time-recovery API, part of Durable Objects Storage API.

You cannot enable a SQLite storage backend on an existing, deployed Durable Object class. Automatic migration of deployed classes from their key-value storage backend to SQLite storage backend will be available in the future.

During the initial beta, Storage API billing is not enabled for Durable Object classes using SQLite storage backend. SQLite-backed Durable Objects will incur charges for requests and duration. We plan to enable Storage API billing for Durable Objects using SQLite storage backend in the first half of 2025 after advance notice with the following pricing.

Durable Objects - New error message for overloaded Durable Objects

Sat, 07 Sep 2024 00:00:00 GMT

Introduced a new overloaded error message for Durable Objects: "Durable Object is overloaded. Too many requests for the same object within a 10 second window."

This error message does not replace other types of overload messages that you may encounter for your Durable Object, and is only returned at more extreme levels of overload.

Durable Objects - 2024-06-24

Mon, 24 Jun 2024 00:00:00 GMT

Exceptions thrown from Durable Object internal operations and tunneled to the caller may now be populated with a .retryable: true property if the exception was likely due to a transient failure, or populated with an .overloaded: true property if the exception was due to overload.

Durable Objects - Durable Objects support for Oceania region

Wed, 03 Apr 2024 00:00:00 GMT

Durable Objects can reside in Oceania, lowering Durable Objects request latency for eyeball Workers in Oceania locations.

Refer to Durable Objects to provide location hints to objects.

Durable Objects - Billing reduction for WebSocket messages

Mon, 01 Apr 2024 00:00:00 GMT

Durable Objects request billing applies a 20:1 ratio for incoming WebSocket messages. For example, 1 million Websocket received messages across connections would be charged as 50,000 Durable Objects requests.

This is a billing-only calculation and does not impact Durable Objects metrics and analytics.

Durable Objects - Optional `alarmInfo` parameter for Durable Object Alarms

Thu, 15 Feb 2024 00:00:00 GMT

Durable Objects Alarms now have a new alarmInfo argument that provides more details about an alarm invocation, including the retryCount and isRetry to signal if the alarm was retried.