List

the list element is a powerful repeating container that allows users to add, edit, and remove multiple structured items within a single form each list item shares the same field structure (defined by child elements), making it perfect for collecting variable length datasets — like line items, team members, contact entries, or any repeating data group the list is highly configurable you can set minimum and maximum item counts, control whether users can add or remove rows (canadd / canremove), and customize the add button label data can come from a static definition, json, or a live url endpoint — and the full array of item values is accessible at runtime via value, ready to flow directly into process variables the special $item and $fields event context variables give you access to the currently active item and its fields when responding to per row events, enabling row level logic like validating a specific entry or triggering a process for an individual line item key use cases • purchase order line items — product, quantity, unit price, total per row • team member entry — name, role, email for each person on a project • dynamic checklists — user adds tasks, marks them complete, removes irrelevant ones • pre populating a list from a process variable (json array) on form load • enforcing a minimum of 1 and maximum of 10 items using min and max runtime api — attributes in procesio forms all attributes below are accessible and modifiable at runtime via the element's data model in procesio forms — including $item and $fields context variables available within per row events api name description type default notes label display label for the list string — — tooltip help text shown alongside the label string — — readonly if true, existing items cannot be edited boolean false — visible controls element visibility boolean true — value the full array of list item values — read or set at runtime any\[] \[] — sourcetype how initial data is loaded string — json, url sourcevalue the data source value for pre populating items string|any — — addmultiplefields allows adding multiple field groups per item boolean — — min minimum number of items required number|null — — max maximum number of items allowed number|null — — canadd whether the user can add new items boolean — — canremove whether the user can remove items boolean — — addbuttontext custom label for the add item button string — — $item current item object — available in per row events any — event context variable $fields current item's fields object — available in per row events any — event context variable name unique element name string — — id unique element id string — — for support, please join our https //discord com/invite/cebukgjefv for further assistance and support