When to use Store
- You want to track how a value changes over time across runs: prices, quantities, scores.
- You need to compare the current run’s data against the most recent previous value without calling an external API.
- You want to accumulate a running total or average across multiple runs (e.g., daily volume, average invoice amount).
- A downstream HTTP action or Validation node needs historical context that does not live in the current document.
Prerequisites
Before using a Store node, create at least one store under Settings > Stores. The node references a store by name; if no store exists, the node cannot be configured.Modes
The Store node operates in one of two modes, selected in the node editor.Set
Appends the resolvedvalue under the given key. The write is idempotent per run and node: if the same pipeline run triggers the same Store node twice, only one entry is written.
| Field | Type | Required | Description |
|---|---|---|---|
| Store | select | Yes | The managed store to write to |
| Key | text | Yes | The key to write under. Supports template expressions, e.g. {{extract.payload.sku}} |
| Value | text | Yes | The value to store. Supports template expressions, e.g. {{extract.payload.price}} |
| Fail on null value | toggle | No | When on, the run fails if the value resolves to null or empty (a missing or unresolved reference, a JSON-null field, or a blank value). Default off |
Get
Reads the series for a key and returns the result as the node’s payload. Three operations are available.| Field | Type | Required | Description |
|---|---|---|---|
| Store | select | Yes | The managed store to read from |
| Key | text | Yes | The key to read. Supports template expressions |
| Operation | select | Yes | What to return: Latest, Last N, or Aggregate |
| Window | select | No | Optional time filter: Relative or Range (see below) |
Latest
Returns the single most recent entry for the key. The result lands atpayload.value.
Last N
Returns the most recent N entries as a list. The result lands atpayload.values.
| Field | Type | Required | Description |
|---|---|---|---|
| N | number | Yes | How many recent entries to return (minimum 1) |
Aggregate
Computes a number over the series. The result lands atpayload.aggregate.
| Field | Type | Required | Description |
|---|---|---|---|
| Function | select | Yes | Average, Sum, Minimum, Maximum, or Count |
| Value path | text | No | Dot-path into each stored JSON value to extract the numeric field before aggregating (e.g. price or data.amount). Not used for Count |
Window
All three operations accept an optional Window to restrict which entries are included.| Window type | Fields | Description |
|---|---|---|
| Relative | Amount, Unit | Entries from the last N hours, days, weeks, or months |
| Range | From, To | Entries between two dates. Both fields support template expressions, e.g. {{vars.payload.startDate}} |
Output
Read downstream as{{storeName.payload.<field>}} where storeName is the node name in your pipeline.
| Field | Present when | Description |
|---|---|---|
storeId | Always | The ID of the store that was accessed |
key | Always | The resolved key that was read or written |
appended | Set mode | true when the write succeeded; false when it was skipped (idempotent duplicate) |
found | Get mode | true when at least one entry matched the key (and window, if set) |
value | Get, Latest operation | The most recent stored value. null when found is false |
values | Get, Last N operation | Array of recent stored values, newest first. Empty array when found is false |
aggregate | Get, Aggregate operation | The computed number. null when found is false or no entries had a resolvable value |
count | Get, Aggregate operation | The number of entries included in the aggregate (after window filtering) |
Example: price change detection
A purchase-order pipeline captures each line item’s unit price on every run and surfaces a warning when the price has changed. Set node (runs when the order arrives):{{vars.payload.priceChanged}}.
Inputs and outputs
Allowed inputs: All trigger nodes and all action nodes. Output: A payload object with the fields listed in the Output section above.Credits
Store nodes are free. They consume 0 credits per execution.Related
Stores settings
Create and manage store resources
Variable
Define named values that live only within a single run
HTTP action
Call external APIs to read or write data mid-pipeline
Expressions and filters
Template syntax for key and value fields