Skip to main content

Extract Values

This node creates a simple array of values from an array of objects.

The Extract Values node (also known as Pluck) isolates a single property from a list of objects.

The Extract Values node iterates through an array of objects and extracts the value of a specific property (defined by Key Path) from each one. The result is a flat array of those values.

Inputs

Input

DataDescription
ArrayThe source array of objects.

Extract Options

DataDescription
Key PathThe property path to extract (e.g., "id", "user.email").

Actions

SignalDescription
DoTriggers the extraction.

Outputs

Data

DataDescription
Extracted ArrayThe resulting array of values.

Signals

SignalDescription
DoneTriggered when complete.

Usage

Use this to simplify data for charts, dropdowns, or calculations.

Example Use Cases

  1. Dropdown Values: Convert a list of User objects into a list of names for a dropdown menu.
    • Input: [{id:1, name:"Alice"}, {id:2, name:"Bob"}]
    • Key Path: name
    • Result: ["Alice", "Bob"]
  2. Chart Data: Extract sales from a list of DailyReport objects to feed into a Line Chart.
  3. ID List: Get a list of IDs to send to an API for bulk deletion.

Detailed Behavior

  1. Deep Access: Supports dot notation (e.g., address.city).
  2. Preserves Order: The output array matches the order of the input array.
  3. Length Matching: The output array has the same length as the input array.

Troubleshooting

  • Undefined Values: If a key path doesn't exist on an object, the extraction fails for that item.