---
name: "batchSetStorageSync"
mode: "kit"
versionRequirements:
  - { name: "BaseKit", version: "3.30.1" }
  - { name: "@ray-js/ray", version: "1.7.60" }
platform:
  - "iOS"
  - "Android"
---

## batchSetStorageSync

> [VERSION] BaseKit >= 3.30.1 | @ray-js/ray >= 1.7.60

> [PLATFORM] iOS, Android

### Description

Batch store data under the specified key in local storage. This overwrites the existing value for that key. Data remains available unless the user deletes it or the system clears it due to storage constraints. The maximum data size per key is 1 MB, and the total storage limit is 10 MB.

### Parameters

| Property | Type | Required | Default | Since | Description |
| --- | --- | --- | --- | --- | --- |
| `kvList` | `StorageDataBean[]` | Yes | - | `3.30.1` | List of key-value pairs for batch storage |

### Examples

#### Demo

```tsx
import { batchSetStorage } from '@ray-js/ray'

// Batch write to local storage (kvList is a key-value list)
batchSetStorage({
  kvList: [
    { key: "k1", data: "v1" },
    { key: "k2", data: "v2" },
  ],
  success: () => console.log("Batch write completed"),
  fail: error => console.error(error),
});
```