Storage

Interaction

Storage is a widget flow node that manages browser storage operations including cookies, localStorage, and sessionStorage.

Description

The Storage node allows you to read, write, and remove data from various browser storage mechanisms. This is useful for persisting user preferences, session data, or any other information that needs to be stored on the client side.

INFO

Note: You only have access to storage on your own domain.

Configuration

The configuration consists of a list of storage entries, each defining a specific storage operation.

Storage Type

Storage Type – the type of browser storage to use:

• Cookie – browser cookies with configurable expiration
• Local Storage – persistent browser storage that survives browser sessions
• Session Storage – temporary storage that is cleared when the browser session ends

Action

Action – the operation to perform:

• GET – retrieve a value from storage (returns '' if value is missing)
• SET – store a value in storage
• REMOVE – delete a value from storage
• GET & REMOVE – retrieve a value and then remove it (returns '' if value is missing, useful for one-time data)

Key

Key – the storage key to operate on.

Value

Value – the value to store (for SET operation).

Timeout

Timeout – We provide the ability to poll for a value. For example, if a certain value becomes available with a delay, you can set a timeout. In this case, the flow will pause and wait for up to the specified number of seconds. If the value never appears, the behavior will be the same as if it never existed. If the value appears within that time, we will read it and the flow will continue. Works for all storage types.

Max Age

Max Age – Specifies the maximum age in seconds. Works for all storage types. The behavior of the value -1 depends on the storage type.

Storage Type	Max Age = -1 behavior
Cookie	Cookie is deleted when browser session ends
Local Storage	Value persists indefinitely
Session Storage	Value persists until browser session ends

Limitations

Name	Value
Max entries	100
Max key input length	32
Max value input length	2048
Max compiled value length	Unlimited
Max timeout	10 seconds
Max maxAge	31536000 seconds (1 year)
Inputs	Exactly one
Outputs	Exactly one

WARNING

Keep in mind the browser limitations (per domain):

• Cookies: ~4 KB per cookie, typically up to 50 cookies
• Local Storage: ~5-10 MB total
• Session Storage: ~5 MB total

Context values

Only GET and GET & REMOVE entries are returned in the context values.

The context value name will have the format {type}_{key}, where:

• type — the storage type (cookie for cookies, ls for localStorage, and ss for sessionStorage)
• key — the key converted according to the context value naming rules