Skip to main content

Overview

Placeholders pass data between blocks in your workflow. They connect user inputs, step outputs, and brand information throughout the execution sequence. Three types of placeholders:
  1. Input Placeholders: Values defined by the user in the Input block
  2. Step Output Placeholders: Data returned by previous workflow steps
  3. Brand Kit Placeholders: Attributes from a Brand Kit input field

Input Placeholders

Input placeholders are defined in your workflow’s Input Block. Syntax:

Example

If your Input Block defines a placeholder called keyword, reference it in any later step:
You can define multiple custom inputs (topic, url, audience). They automatically appear in the placeholder selector inside each block.

Step Output Placeholders

Each step generates an output you can reference in later steps. Syntax:
Where <n> is the step number (step_1, step_2, etc.).

Example

If Step 1 is a Google Search block and Step 2 is an LLM block, reference Step 1’s results in your Step 2 prompt:

Accessing Structured Data

If a step returns structured data (JSON), access specific properties:

Brand Kit Placeholders

When your Input Block has a field of type Brand Kit, reference its data through that field’s variable name. Syntax:

Example

For a Brand Kit field named brandkit:
selected.* refers to the item the runner picked at runtime for a section you exposed (Products, Content, Audiences, or Geography). See Brand Kit for the full setup.

Best Practices

  • Use the Placeholder Selector ({ } icon on the top left) to insert placeholders without typing manually
  • Check the Test Panel to preview step outputs before referencing them
  • For JSON outputs, expand the result in the Test Panel to confirm the correct structure (keys, arrays)
  • Placeholders can only reference previous steps, not future ones

Common Use Cases


What’s Next

Now that you understand placeholder referencing: