Characteristics
- Scope: Global to the workflow (all nodes in flow agent; entire prompt in single-prompt agent)
- Where to define: Variables panel at workflow level
- Default values: Any supported data type
- Reference syntax:
{{variable_name}} - Single-prompt agents: Custom variables are exposed as
paramsin the agent configuration
When to Use
- Values that change per deployment (e.g. business name, support email)
- Default messages or responses
- State or configuration shared across the flow
- Single-prompt agents: Any data you want to pass into the prompt as parameters
Example Use Cases
Flow Builder vs Single Prompt Agents
In single prompt agents, custom variables are the only user-defined variables; there are no extracted or static variables. See Single Prompt Agent Variables for availability, configuration examples, and when to upgrade to Flow Builder. See Template Syntax & Naming for naming and syntax.