labvanced logoLabVanced
  • Research
    • Publications
    • Researcher Interviews
    • Use Cases
      • Developmental Psychology
      • Linguistics
      • Clinical & Digital Health
      • Educational Psychology
      • Cognitive & Neuro
      • Social & Personality
      • Arts Research
      • Sports & Movement
      • Marketing & Consumer Behavior
      • Economics
      • HCI / UX
      • Commercial / Industry Use
    • Labvanced Blog
    • Services
  • Technology
    • Feature Overview
    • Code-Free Study Building
    • Eye Tracking
    • Mouse Tracking
    • Generative AI Integration
    • Multi User Studies
    • More ...
      • Reaction Time/Precise Timing
      • Text Transcription
      • Heart Rate Detection (rPPG)
      • Emotion Detection
      • Questionnaires/Surveys
      • Experimental Control
      • Data Privacy & Security
      • Desktop App
      • Mobile App
  • Learn
    • Guide
    • Videos
    • Walkthroughs
    • FAQ
    • Release Notes
    • Documents
    • Classroom
  • Experiments
    • Cognitive Tests
    • Sample Studies
    • Public Experiment Library
  • Pricing
    • Licenses
    • Top-Up Recordings
    • Subject Recruitment
    • Study Building
    • Dedicated Support
    • Checkout
  • About
    • About Us
    • Contact
    • Downloads
    • Careers
    • Impressum
    • Disclaimer
    • Privacy & Security
    • Terms & Conditions
    • Third-Party Licenses
  • Appgo to app icon
  • Logingo to app icon
Learn
Guide
Videos
Walkthroughs
FAQ
Newsletter Archive
Documents
Classroom
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
Guide
Videos
Walkthroughs
FAQ
Newsletter Archive
Documents
Classroom
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
  • Guide
    • GETTING STARTED

      • Task Editor
      • Stimulus Presentation
      • Correctness of Response
      • Objects
      • Events
      • Variables
      • Task Wizard
      • Trial System
      • Study Design
        • Tasks
        • Blocks
        • Sessions
        • Groups
    • FEATURED TOPICS

      • Randomization & Balance
      • Eye Tracking
      • Questionnaires
      • Desktop App
      • Sample Studies
      • Participant Recruitment
      • API Access
        • REST API
        • Webhook API
        • WebSocket API
      • Other Topics

        • Precise Stimulus Timings
        • Multi User Studies
        • Head Tracking in Labvanced | Guide
    • MAIN APP TABS

      • Overview: Main Tabs
      • Dashboard
      • My Studies
      • Shared Studies
      • My Files
      • Experiment Library
      • My Account
      • License & Services
    • STUDY TABS

      • Overview: Study-Specific Tabs
      • Study Design
        • Tasks
        • Blocks
        • Sessions
        • Groups
      • Task Editor
        • Task Controls
        • The Trial System
        • Canvas and Page Frames
        • Objects
        • Object Property Tables
        • Variables
        • System Variables Tables
        • The Event System
        • Text Editor Functions
        • Eyetracking in a Task
        • Head Tracking in a Task
        • Multi-User Studies
      • Settings
      • Variables
      • Media
      • Texts & Translate
      • Launch & Participate
      • Subject Management
      • Dataview and Export
        • Dataview and Variable & Task Selection (OLD Version)
        • Accessing Recordings (OLD Version)
  • Videos
    • Video Overview
    • Getting Started in Labvanced
    • Creating Tasks
    • Element Videos
    • Events & Variables
    • Advanced Topics
  • Walkthroughs
    • Introduction
    • Stroop Task
    • Lexical Decision Task
    • Posner Gaze Cueing Task
    • Change Blindness Flicker Paradigm
    • Eye-tracking Sample Study
    • Infant Eye-tracking Study
    • Attentional Capture Study with Mouse Tracking
    • Rapid Serial Visual Presentation
    • ChatGPT Study
    • Eye Tracking Demo: SVGs as AOIs
    • Multi-User Demo: Show Subjects' Cursors
    • Gamepad / Joystick Controller- Basic Set Up
    • Desktop App Study with EEG Integration
    • Between-subjects Group Balancing and Variable Setup
  • FAQ
    • Features
    • Support Policy & Guidelines
    • Security & Data Privacy
    • Licensing
    • Precision of Labvanced
    • Programmatic Use & API
    • Using Labvanced Offline
    • Troubleshooting
    • Study Creation Questions
  • Newsletter Archive
  • Documents
  • Classroom

Creating Variables

Variables in Labvanced are global to the study and can be created in four ways:

  • Variables Tab: create variables in advance from the global variable list
  • Task Editor Variables Panel: create a variable without leaving the editor
  • Object Prompt: Labvanced prompts you automatically when adding a response-capturing object
  • Event System: create and select a variable in one step while building event logic

Tip: Before building your study, write down the variables you need, what they should measure, and when they should be recorded. It is much easier to create variables with a clear plan than to add them incrementally as you go.

From the Variables Tab

The Variables tab gives you a global view of all variables in the study. To create a variable here:

  1. Open your study and navigate to the Variables tab in the left panel.
  2. Click the + New Variable button.
  3. Give the variable a name, set the Data Type, and configure any other properties.
  4. Click Save.

This is the best place to create variables in advance before you start building tasks, or to review and edit all variables in one place.

From the Task Editor Variables Panel

While working in the task editor, the Variables panel tab in the top-right corner lists all variables currently used on the selected frame. You can create a new variable directly from here without leaving the editor.

  1. Open a task in the task editor.
  2. Click the Variables tab in the top-right panel.
  3. Click + New Variable.
  4. Name the variable and configure its properties.

When Adding an Object

Certain objects require a linked variable to store participant responses. When you add one of these objects to a frame, Labvanced automatically prompts you to name a variable. The variable is created and linked to the object in one step.

Objects that trigger this prompt include: input fields, checkboxes, sliders, dropdowns, Likert scales, and other questionnaire elements.

If the variable already exists, you can select it from the list instead of creating a new one.

From the Event System

When setting up an event action that involves a variable (such as Set / Record Variable), the Value Select Menu opens. Go to the New Variable tab, fill in the name and properties, and click Ok. The variable is created and immediately selected for the action.

This is the most common way to create variables when you are building event logic and realize you need a new one mid-flow.

Naming Variables

Variable names must be unique across the entire study. Two variables cannot share the same name. Use descriptive names that make clear what the variable measures and at what level, for example rt_image_click for a reaction time or correct_response for an accuracy flag.

Avoid periods (.) in variable names. Spaces and special characters may also cause issues: stick to letters, numbers, and underscores.

Further reading

Variable Properties

A full reference for every variable setting: data type, scale, format, start value, reset behavior, and recording options.

Time Series Variables

How to record continuous measurements like mouse position or physiological signals using the time series record type.

Working with Variables

The hub page for the working-with-variables section: types, properties, recording options, and data frames.