Docs / Transformers / Map Keys

Map Keys

Reshape the payload: each row defines a new key from a {{ }} value template — outputKey → {{value}}. Use it to flatten nested data so downstream nodes read it cleanly.

Ports

Inlet
Input (any)
Outlet
Output (any)

Configuration

Parameter Type Default Description
mappings key-value pairs Rows of outputKey → {{value template}}. The left side is the new key name; the right side is a {{ }} expression (with the variable picker). A single {{path}} keeps the real value type; e.g. latitude → {{response.latitude}} lifts a nested value to a top-level {{latitude}}.
passthrough boolean true When true, unmapped keys are included in the output. When false, only explicitly mapped keys appear.

Output Payload

The output payload carries each configured output key, resolved from its {{ }} template; unmapped keys are passed through or dropped depending on the passthrough setting.

Example