Running a spreadsheet of items
Download a CSV template shaped to your flow's own columns, fill it in — text and public image URLs — and upload it to run the whole sheet.
In this article (5)
Typing rows is fine for three items and miserable for a hundred. Batch import is how a real catalogue gets in: your flow tells you exactly which columns it wants, you fill a sheet, and the run works through it.
The three steps
- Download the template. Press Batch on a workflow card (or in the Builder top bar) and download the CSV. The columns come from your flow's own batch card, so the header is always the right shape — you never have to guess a column name.
- Fill it in. One row per item. Text cells as-is. Image cells take a public image URL.
- Upload and run. Choose the file, press Run batch. It becomes a normal run, visible in Runs like any other.
How image columns are named
An image column arrives in the CSV with a suffix, so it is obvious what belongs there:
| Batch card column | CSV header | Contents | |
|---|---|---|---|
product_image (one image) | product_image_url | One public image URL | |
inspiration (several images) | inspiration_urls | Several URLs, separated by ` | ` or a comma |
The downloaded template includes an example row showing exactly that.
The limits, plainly
- 200 rows per sheet. More than that is refused with a clear message rather than half-run.
- Images must be publicly reachable over http(s) and at most 12 MB each. FlowArray fetches them server-side and stores a copy, so a URL that needs a login, or an internal/loopback address, is refused — a deliberate guard, not a bug.
- A row with an empty image cell simply has no image for that column. If a step needed one, that item will fail on its own without affecting the rest.
- The sheet must be CSV. (XLSX support would mean a new dependency and is not in yet.)
Getting it right first time
Before running two hundred rows, upload the same sheet cut to three rows and look at the Data tab — column typos and empty cells show up there for $0 rather than costing a full batch. The commonest mistake is a header renamed by hand so it no longer matches the flow's column.