diff --git a/src/content/docs/durable-objects/api/storage-api.mdx b/src/content/docs/durable-objects/api/storage-api.mdx index a656a4670baab1..f38c7aa2213c90 100644 --- a/src/content/docs/durable-objects/api/storage-api.mdx +++ b/src/content/docs/durable-objects/api/storage-api.mdx @@ -9,6 +9,15 @@ import { Render, Type, MetaInfo, GlossaryTooltip } from "~/components"; The Durable Object Storage API allows Durable Objects to access transactional and strongly consistent storage. A Durable Object's attached storage is private to its unique instance and cannot be accessed by other objects. +:::note[Scope of Durable Object storage] +Note that Durable Object storage is scoped by individual Durable Objects. + +- An account can have many Durable Object namespaces. +- A namespace can have many Durable Objects. + +However, storage is scoped per individual Durable Object. +::: + Durable Objects gain access to a persistent Durable Object Storage API via `ctx.storage`, on the `ctx` parameter passed to the Durable Object constructor. While access to a Durable Object is single-threaded, request executions can still interleave with each other when they wait on I/O, such as when waiting on the promises returned by persistent storage methods or `fetch()` requests.