Skip to main content
Use this step to gather every item flowing through it and write them all into a single file on a filesystem connection. You choose where the file goes, how the items are formatted in it, and what should happen if a file already exists at that location. After the file is written, the step passes on a single item containing the path of the file it created, so a later step can pick up that path and act on it. Because it gathers all incoming items into one file, anything after this step works with the file path rather than the original items.

​
Fields

​
Sample data

This step runs as part of a route, writing to a filesystem connection rather than transforming an item in place, so there is no before/after to show. It collects every item passing through, writes them into one file using the chosen formatter, and then outputs a single item with the path of the file it created, for example { "path": "exports/products.csv" }. A small example configuration that writes all items as a CSV to a filesystem connection: