> For the complete documentation index, see [llms.txt](https://doc.duaer.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/data/data-structure.md).

# Understand Duaer’s data structure

Understanding how Duaer structures and passes data between nodes is fundamental to building workflows. This guide covers the data structure format and how data flows.
## Data structure <a href="#data-structure" id="data-structure"></a>

In Duaer, all data passed between nodes is an array of objects. It has the following structure:

```
[
	{
		"json": {
			"apple": "beets",
			"carrot": {
				"dill": 1
			}
		},
		"binary": {
			"apple-picture": {
				"data": "....",
				"mimeType": "image/png",
				"fileExtension": "png",
				"fileName": "example.png"
			}
		}
	}
]
```

Put ordinary fields under json. Put files under binary on the same item. In the Code node, Duaer adds a missing json key and wraps a bare object in an array when needed. Custom nodes must still return items that include json.

## How data flows within nodes <a href="#how-data-flows-within-nodes" id="how-data-flows-within-nodes"></a>

When you connect nodes, data passes from one node to the next automatically. Nodes process multiple items automatically: when a node receives an array of items, it performs the configured operation for each one.

For example, if you set a node to create a card and build the Name from an incoming field with an expression, the node creates one card per item.

Execute Once in the node settings is the exception: the node runs a single time for the whole input.

## Understand what you are mapping with drag and drop <a href="#understand-what-youre-mapping-with-drag-and-drop" id="understand-what-youre-mapping-with-drag-and-drop"></a>

Data mapping maps the field path and loads the field’s value. Dragging fruit from the INPUT pane into a parameter creates {{ $json.fruit }}. When the node iterates over items, the field becomes the fruit value for each item.

## Understand nested data <a href="#understand-nested-data" id="understand-nested-data"></a>

In the table view, a nested object is collapsed under a bold field name. Open it to see the keys inside. In an expression, walk down with dots, for example nested.example-string-field.
## Questions

### What does one item passed between nodes contain?

In Duaer, a node output is an array of objects. Each item has json for ordinary fields, and binary when a file is attached. Most nodes run once per item.

### What does dragging a field from the INPUT pane insert?

In Duaer, an expression that points at the current item, such as {{ $json.customerId }}. It maps the field path; it does not freeze the value at drag time.

## Related

- [Work with files and images in Duaer](https://doc.duaer.com/data/binary-data.md)
- [Use the UI mapper in Duaer](https://doc.duaer.com/data/schema-preview.md)
- [How items link across Duaer nodes](https://doc.duaer.com/data/data-mapping/data-item-linking.md)

