Format Data

Turn data (objects or arrays) into a readable string using a template. Use {{@field}} placeholders to reference fields from your data, or {{@}} for arrays of plain values such as the output of Extract Field from Array. For number formatting (commas, currency), use the Run JavaScript action instead.

Built-in action Built In

Turn data (objects or arrays) into a readable string using a template. Use {{@field}} placeholders to reference fields from your data, or {{@}} for arrays of plain values such as the output of Extract Field from Array. For number formatting (commas, currency), use the Run JavaScript action instead.

At a Glance

FieldValue
Action IDformat
CategoryBuilt In
ConnectorNot required
Requires gasNo
Funds movementNone declared
Tagsutility, formatting, string, template, data-processing

Payload Schema

FieldTypeRequiredDescription
dataarray | objectYesData object or array. An array may hold objects, whose fields the template reads by name, or plain values like addresses or symbols, which the template inserts with {{@}}. Can use workflow variables like {{root.result.triggeredAt}} which will be resolved before formatting. The result becomes the data source for template placeholders.
templatestringYesTemplate with {{@field}} placeholders. IMPORTANT: Use @ prefix to reference data fields (e.g., {{@name}}, {{@user.email}}). The @ prefix distinguishes template-local variables from workflow variables (like {{root.result.x}}). When the data is an array of plain values rather than objects — what Extract Field from Array returns — write {{@}} for the value itself, since a string or a number has no field to name.
separatorstringNoSeparator for array items (default: newline)

Result Schema

FieldTypeRequiredDescription
formattedstringYesFormatted string result

Examples

json
{  "type": "format",  "payload": {    "data": {      "triggeredAt": "{{root.result.triggeredAt}}",      "price": "{{root.result.price}}"    },    "template": "{{@name}} is {{@age}} years old"  },  "children": []}

Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.