Variable Selector

Overview

The Variable Selector is a visual tool in Automation workflows that lets you reference output data from upstream triggers or actions. It helps pass data between steps, making it easy to handle more complex business scenarios.

For example, to set up a workflow for sending mass emails:

1. Use the Get Records action to filter a list of target customers.
2. Use a Loop action to process each customer one by one.
3. For each customer, use the DeepSeek – Text Generation action to create a personalized email.
4. Finally, pass the customer's email address as a variable to the Send Email action.

How to Use It

1. While setting up an action in the workflow, click into an input field.
2. Press the / key on your keyboard to invoke the Variable Selector.
3. Browse available variables in the pop-up menu.
4. Click on a variable to insert it into the current field.

Note: Not all fields support variable insertion. Please follow the on-screen hints when configuring.

How It Works

The Variable Selector shows the output of all triggers and actions that run before the current step. Each trigger or action produces structured JSON output when executed. The selector turns this into a clickable list for easy reference.

To make sure variables load correctly, click Run Test in the trigger or action panel. This generates the necessary output for the picker to use.

Variable Data Types

Variables are based on JavaScript data types. Common types include:

• Object
• Array
• String
• Number

Each variable in the list has an icon to show its type.

Object Type

• A ">" icon means the object can be expanded to view subfields.
• A "Select" button lets you insert the entire object if supported.

Array Type

Just like objects, arrays can be expanded to see individual items. Arrays are often used with the Loop action to handle multiple entries at once.

Example:

1. The Get Records action returns an array of customer records.
2. The Loop action processes each customer individually.
3. The personalized message and email address are passed to the Send Email action.

Below is a GIF showing how to use the Get Records output as input in the Loop action:

String & Number

• These don't have subfields, so there's no expand icon.
• Just click to insert directly.

Special Variables

Some triggers or actions output preformatted text variables. These usually come from database-related components like:

• When record meets condition (trigger)
• When new record is created (trigger)
• Get/Create/Update Record (actions)

• The variable Record List (Text) outputs a list of records in Markdown format. It's best used with the Send Report or Send Email actions. When inserted into an report, it looks like this:

  

• The variable Grid List (Text) outputs a table of records in Markdown format.

  

How to View Variable Structure or Values

To use a variable correctly, preview its structure by running a test:

1. Click Run Test in the trigger or action panel.
2. Check the full JSON output in the popup.

Note: Some components like the Webhook trigger only generate output when a real request is received. If "Run Test" doesn’t work:

• Go to the main workflow view.
• Click Run Now to perform a real execution.
• Then check the output in the Run History panel.

FAQs

• Only outputs from previous steps (that have been tested or run) will show up.
• Make sure to run a test or perform a real execution for each step.

Q: How can I check the structure of a variable? Run the workflow once, then go to the "Run history" to view the output of each step and inspect the variable structure.

Recommend AI Automation Templates

Beginner's Playground

A template suitable for beginners to learn, containing examples of all resource types supported by Bika. You can learn and modify it to your desired effect.

Content Marketing for SEO

Use the Content Marketing for SEO template as a powerful content strategy template to streamline SEO content management and content workflow management from idea to publication. This content marketing automation setup helps you align content with SEO keywords, manage personas for persona based marketing, and track every step in a visual content marketing dashboard and content performance dashboard. Improve online visibility by organizing topics, workflows, and campaigns in one place so your team can plan, produce, and optimize SEO content more efficiently.

Contractor / Freelancer Management

Streamlined contractor and freelancer management template that centralizes resources, automates application reviews, approval workflows, task assignment, and tracks project expenses for full transparency and budget control.

Assortment Planning

The Assortment Planning template is a retail assortment planning solution that helps you manage product assortment planning across categories, seasons, and channels. Use it as a centralized product catalog management system and manufacturer database to support supplier relationship management and retail product management. Track pricing, costs, and product margin analysis, organize your product portfolio planning with clear categories and color variants, and use built‑in category management tools to keep assortments optimized for every store or sales channel.

Device Asset Management

Streamline your device management with this Device Asset Management Template. Track device status, log maintenance and service requests, assign tasks, and manage service tickets efficiently. Maintain a comprehensive asset database and device inventory, optimize maintenance workflow, use client forms for easy submissions, and monitor progress on a dynamic service dashboard for improved hardware management and client support.

Business Contract Management

Streamline your entire contract lifecycle with the Business Contract Management template. This centralized contract management system serves as an all-in-one contract database and centralized contract repository for tracking contract details, approvals, and activities. Automate key processes through a contract approval workflow and contract workflow management, ensuring accuracy, transparency, and collaboration across teams. Ideal for project contract management, this template simplifies service request tracking, reduces manual work, and improves efficiency from contract submission to expiration reminders.