> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.meetgail.com/platform/workflows/guides-and-recipes/recipes/reshape-data/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.meetgail.com/_mcp/server.

# Reshape Data

> Transform a single value or object, or reshape every item in a list.

Data rarely arrives in exactly the shape the next step wants. Maybe you need to
combine two fields, rename a key, or turn a list of raw records into a clean list
of just the fields you care about. Which node you reach for depends on whether
you are working with one thing or a list.

## Which node to use

* Use [Data Transform](/platform/workflows/node-reference/logic-and-flow/data-transform)
  when you are shaping a single value or a single object, such as building one
  clean record out of a few fields.
* Use [Map](/platform/workflows/node-reference/logic-and-flow/map) when you are reshaping
  every item in a list, turning a list of raw rows into a list of tidy ones.

The simplest way to remember it: one thing means Data Transform, a list means
Map.

## How to build it

### Shape a single value

Add a Data Transform step and write an expression that produces the shape you
want. For example, combining a first and last name into one field:

```
first_name + " " + last_name
```

### Reshape a whole list

Add a Map step, point it at the list, and describe the shape each item should
take. Map applies that shape to every item and hands back the new list, ready
for a loop or a bulk step.

## Related

#### [Data Transform](/platform/workflows/node-reference/logic-and-flow/data-transform)

Shape a single value or object.

#### [Map](/platform/workflows/node-reference/logic-and-flow/map)

Reshape every item in a list.

#### [Expressions](/platform/workflows/core-concepts/expressions/using-expressions-in-nodes)

How to write the expression that does the shaping.

> Documentation for Gail, the AI platform for financial services. Learn how to set up GailGPT and Gail Agent to automate customer communications for insurance, banking, and finance.