Docs / Transformers / Map Keys

# Map Keys

Rename, extract, or reshape payload keys.

## Ports

Inlet
Input (any)
Outlet
Output (any)

## Configuration

Parameter | Type | Default | Description
--- | --- | --- | ---
`mappings` | key-value pairs | — | A list of old key → new key pairs. Supports dot-notation for nested keys (e.g., `resp.data` → `items`).
`passthrough` | boolean | `true` | When `true`, unmapped keys are included in the output. When `false`, only explicitly mapped keys appear.

## Output Payload

The output payload is shaped by the configured mappings. Mapped keys are renamed; unmapped keys are passed through or dropped depending on the `passthrough` setting.

## Example

← Math Extract Text (OCR) →