Skip to main content
Structured output fields let you define the exact data format you want an action to produce. Instead of receiving freeform text that you need to parse, the AI fills in specific fields with the correct data types — making outputs consistent, reliable, and easy to reference in later steps.
Structured output fields are available on these actions: Generate Text, Generate Text with Agent, Run Code, and Research Agent.

​
Set up structured output fields

1

Open the action settings

In the Workflow editor, click the action you want to configure. The settings sidebar opens.
Action settings sidebar showing the Structured Output Fields section
2

Add fields

Under Structured Output Fields, you have two options:
  • Add Fields Automatically — Cassidy analyzes your prompt and generates a suggested set of fields.
  • + Add Field — manually create each field yourself.
Add Fields Automatically and Add Field buttons in the Structured Output Fields section
3

Configure each field

For each field, specify:
  • Field Name — a descriptive label (e.g., “Full Name”, “Location”, “Score”).
  • Type — the data type for this field (see the table below).
  • Description — help the AI understand what value to fill in (e.g., “The person’s complete full name as listed on LinkedIn”).
Edit Field dialog showing Field Name, Type, Description, Required toggle, and Allow Multiple Values toggle
4

Set field options

Customize each field further:
  • Required — toggle on if this field must always be populated.
  • Allow Multiple Values (List) — toggle on if the AI should return more than one value (e.g., a list of skills or multiple work experiences).
Field configuration showing Required and Allow Multiple Values (List) toggles
5

Reference the output in later steps

In subsequent actions, insert a variable and you will see each structured field as an individual variable you can reference by name.
Variable selector dropdown showing individual structured output fields from a previous action

​
Available field types

TypeDescriptionExample
TextA single text value"Jane Smith"
NumberA numerical value42
Yes/NoA true/false toggletrue
DropdownA single value from a list of options you define"CA" from a list of state codes
ObjectA collection of sub-fields with their own typesA work experience with Company Name (Text), Job Title (Text), and Duration (Number)
When using the Object type, you add sub-fields within the object by repeating the same field configuration process. Objects can be combined with Allow Multiple Values to create lists of structured records.

​
Example: parse a LinkedIn profile

To illustrate, here is how you might extract structured data from a scraped LinkedIn profile:
  1. Full Name — Type: Text, Description: “The person’s complete name”
  2. Location — Type: Dropdown, Options: CA, NY, TX, FL (state codes), Description: “The US state where the person is located”
  3. Past Experiences — Type: Object, Allow Multiple Values: on
    • Company Name — Type: Text
    • Job Title — Type: Text
    • Duration in Years — Type: Number
Completed structured output configuration for the LinkedIn profile parsing example with Full Name, Location, and Past Experiences fields
The action produces a clean, structured result where each field is individually referenceable in downstream steps.

​
Next steps

Reference variables

Learn how to pass structured output data between Workflow steps.

Run Workflows in bulk

Apply structured outputs across an entire dataset.