Add To Collection
Description
The Add To Collection activity appends an item to an Agent Data or Workflow Data collection (Field[]).
Use this activity to build collections during workflow execution, such as collecting values from a loop, aggregating results from multiple activities, or constructing a FileReference[] for downstream AI and document-processing activities.
Common Capabilities
Process Data Support
This activity supports dynamic configuration using variables from the Process Data drawer.
You can bind values from Agent Data, Workflow Data, Form Data, System Data, Enterprise Variables, and Activity Outputs.
Learn more → Using Process Data
Design Time Configuration
Display Text
The label displayed for this activity on the workflow canvas.
Collection
The Agent Data or Workflow Data path of the target collection. Select the collection from the Process Data Explorer.
Notes:
- Agent Data and Workflow Data collections are supported. Use Agent Data when other workflows in the same agent execution need the collection.
- The target field must be an array (Field[]).
Examples:
agentData.OrderIds(shared across workflows)modelData.OrderIds(local to the current workflow)modelData.CustomerNamesmodelData.AttachmentFiles
For File Reference collections, see File Reference.
Item
The item to append to the collection.
Use Process Data binding to select a value from:
- Agent Data
- Workflow Data
- Activity Outputs
- Expressions
- System Data
- Form Data
For FileReference[] collections, bind a file handle such as an attachment File output or another file-producing activity output.
Common Activity Features
Wait All Incoming
Controls how this activity behaves when multiple incoming execution paths converge.
Learn more → Execution Control
On Error
Defines how the workflow behaves if this activity encounters a runtime error.
Outputs
This activity does not produce any outputs.