Skip to main content
Custom variables are defined at the workflow level and are available to all nodes (flow agent) or to the single prompt (single-prompt agent). They are ideal for configuration, defaults, and passing caller-specific data.

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 params in 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.