Items List: typed records, AI Fill, views, and repetition

Create typed records, fill them with a selected AI model and rich connected context, review them as a list/grid/carousel, or pair the List with a Results List to run and collect a complete row workflo

Where: Flowgen → Add → Inputs → Items List

Key ideas

Typed record table: Rows are items; named columns are typed fields and per-row outputs. A one-column text table is still the simple-list case.
Author, import, connect, or AI Fill: Edit cells directly, paste/import records, aggregate connected field values, or ask AI Fill to produce rows from a brief using the selected model and connected rich context. Locked rows survive regeneration.
List, Grid, and Carousel: List is the editing view. Grid is a media-forward contact sheet with an adjustable Tile size. Carousel opens complete items fullscreen without changing data.
Repeat into a Results List: Repeat these items creates a paired Results List so body nodes run once per row and exact typed outputs are collected after every item settles.
Previous completed results: Retained completed snapshots can feed later work through Previous results; a current partial run is never exposed as its own history.
Manual or Refresh before Play: Manual is the default and Play uses the rows currently visible. Refresh items before Play regenerates unlocked rows from the typed/wired AI brief, then runs the current graph. A visible sparkle badge identifies Refresh mode and can turn it off.
Typed records can open native editors: The fullscreen spreadsheet preserves typed page and shot cells. A page cell can open once in Website Editor as an editable copy; a shot cell can open in Video & Motion Editor. Transform reads those values as typed files rather than flattening them into labels.
Groups organize; List Iterator repeats: Plain Groups still provide nested structure, typed sockets, reusable components, mini apps, and publishing. Their former Group Repeater / loop mode is deprecated; use a paired source and Results List for repetition.

Steps

Add Items List and define meaningful columns with compatible types.
Create/edit/import rows, or configure AI Fill with a model, prompt, Auto/specific count, and connected context. Lock any row that must survive another fill.
Use List for editing; switch to Grid and adjust Tile for media scanning; use Carousel for fullscreen record review.
For simple downstream use, connect All rows or a typed column output.
For repetition, click Set up under Repeat these items, wire Current <field> outputs through the body, and collect final outputs in the Results List.
Choose Add each run/Replace and Keep input fields, then run a small representative set before scaling.
Use Previous results only when a later run deliberately needs completed earlier context.
Choose Manual when authored rows are the run input, or enable Refresh items before Play when every Play should regenerate unlocked items first.
Use inline editors/replacement actions and the List/Grid/Carousel views to validate complete typed records before a batch run.
Open the fullscreen spreadsheet for dense record work; use List for editing, Grid for contact-sheet review, and the fullscreen record view for one complete row.
Open a page/shot cell in its native editor only when you intend to create an editable copy of that value.
Test a three-row List with visibly different inputs, inspect three collected results and separate saved files, then increase the batch size.

Core editing controls

Column name/type/add/remove/reorder.
Row add/edit/paste/import/reorder.
Per-row locks.
Connected field sources and durable order.
AI Fill prompt, model, Auto/manual count, and rich context.

View controls

List.
Grid.
Tile 90–360.
Carousel with complete-row previous/next navigation.

Iteration controls

Repeat these items → Set up.
Run/Cancel and completed/failed progress.
Add each run / Replace.
Keep input fields.
+ Add output field.
Previous results history.
Nested iteration marker.

Refresh-mode precedence

A runtime rows override or rows_in connection wins and suppresses hot regeneration.
A connected prompt counts as an AI brief.
Locked rows survive AI Fill/refresh according to the List fill contract.
The paired iteration runtime refreshes the source before resolving per-row body inputs only when aiRunMode is refresh.

Current preview behavior

List is the dense editable table.
Grid is a media-forward contact sheet of whole records.
Carousel opens a complete selected row.
HTML/page cells render as pages rather than bare markup.

Current List storage and previews

Large tables and excerpts are stored externally.
Media thumbnails are still images rather than duplicated full files.
Page cells render as pages.
Shot cells retain shot identity and can enter the video editor.
Transform receives the typed underlying values.
Execution still follows row order and schema, regardless of List/Grid/review mode.

Current List execution and connected-item behavior

List repetition uses the active row’s resolved inputs for both generation and deterministic editing nodes. Results collect incrementally, and per-row files get distinct identities instead of repeatedly overwriting one node output. The connected table preserves useful ordering, and specific cell mentions resolve the selected cell rather than an unrelated whole-list value.

AI Fill controls are shared and distinguish manual execution from refresh/regeneration of unlocked items.
List/Grid/Carousel are presentation choices, not different execution engines.
A detached extract-to-input action keeps a fixed item; a connected Extract/Transform continues following the List.
Independent groups can run while another group is still active; this does not waive each run’s input requirements or paid-action gates.

Tips

For new repetition, use Repeat these items or create_list_iteration; never enable a loop/repeater mode on a Group.
Use stable identifier fields.
Test two or three rows before scaling.
Keep shared constants outside the row table.
Use typed result columns rather than a single opaque value when possible.

Limitations and important notes

Grid is a view only.
AI Fill still requires review.
A repeat needs a separate paired Results List at the same group boundary.

Troubleshooting

Every iteration receives the same value

Wire Current <field> from the source List; a shared input intentionally broadcasts.

Results are missing

Connect the final output to + Add output field and ensure its type matches.