About the Storage Item API

The Storage Item API allows you to manage data storage containers across automations. Storage items store data in key-value pairs and support different types, including strings, booleans, numbers, and counters that you can update atomically. Use storage items to synchronize, store, and share data across automations.

Using the Storage Item API, you can:

• Create storage items with different value types.
• Update storage item values.
• Atomically update counters to maintain data integrity.
• Update storage item tags for multiple storage items.
• Get and Query Storage Items.

Atomic updates

Atomic updates either complete fully or fail entirely. They can't succeed partially. Atomic updates help maintain data integrity when multiple automations update the same storage item at the same time.

The Storage Item API supports atomic updates for items of type COUNTER, which you can update by calling Update Storage Item Counter By.

Before you begin

To manage storage items, the site must have at least 1 automation.

Use cases

• Share data across automations.
• Store user preferences.
• Track and update site metrics.

Terminology

• Storage item: A container that stores data across automations in a key-value pair.
• Tag: Label assigned to a storage item, enabling flexible categorization, filtering, and data management. Learn more about tags.
• Counter: Storage type that stores a numeric value that can be incremented or decremented using atomic operations.
• Atomic update: Operation that completes in full or not at all, thereby preserving data integrity during concurrent updates.

See also

• Wix Automations: an overview
• About Wix Automations
• About the Tags API