rudder-js-sdk/skills/rudder-web-sdk/reference/storage.md

# Storage — `client.storage`

Per-player storage, one item per `type`. `StorageDomain`, revision key
`storage`. Source: `src/domains/StorageDomain.ts`.

```ts
client.storage.value   // GetStorageResponse | undefined
await client.storage.reload();
```

```ts
interface GetStorageResponse {
  items?: StorageItem[];
  nextCursor?: string;
}
interface StorageItem {
  data?: string;   // opaque payload, JSON-stringify yourself
  id?: string;     // server-assigned
  type?: string;   // the storage key
}
```

- The client cannot write storage. Module functions (kernel `Storage.Set`) and
  the batch admin API write it; call `reload()` after a module call that saved.

## Limits and notes

- The state loads with `{ limit: 100 }`; `nextCursor` pagination is not
  surfaced.
- `data` is a raw string on the wire; serialize and parse JSON yourself.
- Project storage is not reachable from the client SDK. It stays available to
  modules, the dashboard and `/game/v1`.