> 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/build/split-out.md).

# Split a list into items with Split Out in Duaer

In Duaer, Split Out turns a list inside an item into separate items. Fields To Split Out is required. Include defaults to No Other Fields.
## Break an array into items

1. Start from an item whose json has an array field, for example items.
2. Search for Split Out and connect it after that node.
3. Set Fields To Split Out to that field name, for example items. Comma-separate multiple fields.
4. Leave Include on No Other Fields unless you want other fields copied onto each new item.
5. Select Execute step. Each array element becomes its own output item.

Include can also be All Other Fields or Selected Other Fields (then set Fields To Include).

Options: Disable Dot Notation, Destination Field Name, and Include Binary.

To pack items back together, use Aggregate. Refer to [Aggregate items into one list in Duaer](/build/aggregate.md). For branching, refer to [Split a Duaer run with If and Switch](/flow-logic/splitting.md).
## Questions

### Can Split Out in Duaer take $json as the whole item?

No. Fields To Split Out needs a field name inside json, not $json. If the root value is already an array, wrap it under a named field with Edit Fields or Code first.