Bika
GuideAutomation

Variable Selector

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.

Invoke Variable Selector

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.

Run Test to generate output for Variable Selector

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.

Variable type icons

Object Type

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

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.
Array variable in Loop action

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

Use array output in Loop action

String & Number

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

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)
Preformatted text variable output
  • 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:

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

    Grid List (Text) variable in report

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.
Preview variable structure with Run Test

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.
Run History panel for variable output

FAQs

Q: Why don’t I see certain variables?
  • 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
Automated Currency Data Retrieval (JavaScript)
Automated Currency Data Retrieval (JavaScript)
The Automated Currency Data Retrieval (JavaScript) template runs daily jobs to fetch exchange rates and write them into a table, giving you clean, structured historical exchange rate data without manual copy‑paste. Use it for financial data automation that feeds dashboards, alerts, and automated financial reporting, so finance teams, forex traders, accountants, and analysts always have up‑to‑date FX data. Over time, the template becomes a lightweight risk management tool by helping you monitor currency movements, spot trends, and support better investment and hedging decisions.
Ticket Manager
Collect, analyze, and manage support tickets from forms and databases with AI. This smart ticketing tool helps operations teams prioritize issues, manage internal feedback, and automate issue resolution for faster, more efficient responses.
Community Reporter
Community Reporter generates AI-powered community reports and activity reports, providing clear community insights, analytics, and highlights. Track interactions, monitor trends, and get actionable community analysis quickly and efficiently.
Automated Stock Data Retrieval (JavaScript)
Automated Stock Data Retrieval (JavaScript)
The Automated Stock Data Retrieval (JavaScript) template automatically fetches US stock data every day and writes it into a structured table, giving you clean, consistent time series for analysis. Use it as part of your financial data automation stack to power stock trend analysis, dashboards, alerts, and quantitative analysis data for models and backtests. Designed for financial analysts, investment managers, data scientists, quants, and portfolio managers, it saves time on manual data collection so you can focus on research, strategy, and better investment decisions.
AI Batch Image Recognition(OpenAI gpt-4o)
AI Batch Image Recognition(OpenAI gpt-4o)
Extract text from multiple images at once with Bika.ai's AI Batch Image Recognition. Supports OpenAI gpt-4o, batch processing, and automated image recognition for fast, accurate results.
AI Automated Task Management
AI Automated Task Management
Helps teams efficiently manage weekly tasks. Through a series of automation tools, including task summaries, progress reminders, and personal summary reports, team members can promptly obtain task information and progress, thereby improving collaboration efficiency and work transparency. By using these automation features, teams can maintain efficient operations and ensure that each member has a clear understanding and sense of responsibility for their tasks.