Local Files

The simplest data source: files on disk. Supported formats are .csv, .tsv and .json.

Connecting files

1. Open the Local Data page from the panel.
2. Click Add Files and select one or more data files.
3. Reorder files by dragging if needed, then click Connect.

Double-clicking a file in the list reveals it in Explorer (Windows) or Finder (macOS).

Formats

CSV / TSV need a header row; data starts at row 2.

comp,output,headline
MainComp,v1,Hello

JSON is an array of objects; keys act as column names. There is no header row, so data starts at row 1 (see Row numbering). Numbers and true/false are injected as text, and null counts as an empty cell.

[
  { "comp": "MainComp", "output": "v1", "headline": "Hello" },
  { "comp": "MainComp", "output": "v2", "headline": "World" }
]

Multiple files

You can connect several files at once. Note the split in behavior:

• Batch Render and Data Preview use the first file in the list.
• Agent Mode scans all connected files for ready rows.

Status write-back

In Agent Mode, BatchRender writes render progress back into the file’s status column (rendering..., complete, error: ...), plus any delivery information columns.

Caution

Keep the file closed in other editors while the agent runs. An editor holding a stale copy in memory overwrites the agent’s updates the moment you save.

In a CSV or TSV file, write-back changes only those cells; the rest of the file, including its line endings, is left as it was. A JSON file is saved back with standard indentation, so its layout may change after the first write.