Get Store Items

The Get Store Items node retrieves all items from a named user data store for the current user. User stores are per-user key-value collections used for features like favorites, bookmarks, wishlists, and recently viewed items.

Configuration

Property	Type	Default	Description
storeName	string	--	Required. The name of the data store (e.g., favorites, wishlist, bookmarks). Only lowercase letters, numbers, and underscores are allowed.

Input

This is a source node -- it has no input port.

Output

Returns an array of store entries for the current user, ordered by creation date (newest first):

[
  { "item_id": "42", "created_at": "2025-03-15 09:30:00" },
  { "item_id": "17", "created_at": "2025-03-14 14:20:00" },
  { "item_id": "8", "created_at": "2025-03-10 11:00:00" }
]

Returns an empty array if the user is not logged in or the store is empty.

How It Works

1. The node checks if the user is logged in. If not, returns an empty array.
2. It sanitizes the store name (lowercase, alphanumeric + underscores only).
3. It queries the nexus_user_stores table for all rows matching the current user_id and store_name.
4. Results are ordered by created_at DESC with a limit of 1,000.

Example Use Cases

Display a user's favorite items

1. Get Store Items with storeName: "favorites" returns item IDs.
2. Connect to a For Each node or use a Table Query filtered by the IDs to load full item details.

Show bookmark count

Connect to a Math node with operation: "count" and field: "item_id" to count the number of bookmarked items.

Build a wishlist page

Pipeline:
  Get Store Items (storeName: "wishlist")
    --> Lookup (tableId: products, localField: "item_id", foreignField: "id", outputField: "product")
      --> Result

This enriches each store entry with the full product details from the products table.

TIP

Use the Add to Store and Remove from Store nodes in action pipelines to manage store contents.