labvanced logoLabVanced
Contact
    • Remote Physiological Measurements
    • Eye Tracking
    • Head & Face-Tracking
    • Emotion Detection
    • Heart Rate Detection (rPPG)
    • Generative AI
    • Audio Transcription
    • EEG & Hardware Integrations
    • Decision Making
    • Reaction Times
    • Keyboard Inputs
    • Mouse Tracking
    • Mobile / Touch
    • Questionnaires
    • Gamepad / Joystick Integration
    • Audio Recordings
    • Audio Transcription
    • Video Recordings
    • Screen Recordings
    • Photos / Snapshots
    • Video Conferencing
    • Canvas Drawings
    • Build with AI
    • Build with Spreadsheets
    • Using the Experiment Editor
    • Coding
    • Creating Questionnaires
    • Balancing & Randomization
    • UX & Website Testing
    • Single Session Studies
    • Factorial Designs
    • Longitudinal & Multi-session Studies
    • Individual & Case Studies
    • Real-time Multi-user Studies
    • Interviews & Video Calls
    • Surveys & Questionnaires
    • Experience Sampling & Diaries
    • Classroom & Group Testing
    • Interventions & Clinical Trials
    • In the Browser
    • Mobile App
    • Desktop App
    • WebBridge Chrome Extension
    • Stroop Test
    • Flanker Task
    • N-back Task
    • Implicit Association Test
    • Trail Making Test
    • Digit Span
    • Corsi Block Tapping
    • Tower of London
    • Balloon Analog Risk Task
    • Preferential Looking
    • Browse more →
    • DASS-21
    • GAD-7
    • Rosenberg Self-Esteem Scale
    • PHQ-9
    • Ten-Item Personality Inventory
    • Big Five Personality Test
    • Adult ADHD Self-Report Scale
    • Browse more →
    • Building a Multi-user Study
    • Webcam Eye Tracking with AOIs
    • Website Frame Eye Tracking
    • Conditional Eye Tracking Opt-in
    • ChatGPT Study
    • Desktop App Study with EEG
    • Between-subjects Group Balancing
    • Building a Reading Study
    • Stroop Task
    • Lexical Decision Task
    • Browse more →
    Public Experiment Library
    • Arts Research
    • Clinical Psychology & Neuropsychology Medicine
    • Cognitive Psychology
    • Developmental Psychology
    • Behavioral Economics & Decision Science
    • Educational Research & Psychology
    • HCI & Human Factors
    • Linguistics & Language Sciences
    • Consumer & Marketing Research
    • Social & Personality Psychology
    • Sport & Movement Science
    • UX & Website Testing
    • Executive Functions
    • Language & Reading
    • Decision-Making & Reasoning
    • Attention
    • Overview
    • HCI & Human Factors
    • UX & Website Testing
    • Consumer & Marketing Research
    • White-Label App
    • PageGazer
    • Webcam vs. Lab Eye Tracking in InfantsAnna Banki & Gabriela Markova
    • Eye Tracking for Influencer MarketingDr. Alexander Edeling
    • Eye Tracking Infant Word ComprehensionDr. Giulia Calignano
    • Sentence Reading and Grammar JudgmentsDr. Jonathan Mirault
    • Regulating Emotions with MusicDr. Katrin Starcke
    • Game-Based Grammar Learning in ChildrenDr. Mireia Marimon
    • Gaze Cueing and AutismMax Soares Miehstein
    • Personality and Hearing in NoiseDr. Malte Wöstmann
    • All interviews →
    • Lab Notes
    • How to Cite Labvanced
    • Labvanced Platform Paper (2017)
    • Webcam Eye Tracking Validation (2024)
    • Webcam Eye Tracking Studies
    • Cognitive Psychology Studies
    • Developmental Psychology Studies
    • Linguistics Studies
    • See all publications →
    • Getting Started
    • Guide
    • Video Tutorials
    • Walkthroughs
    • Live Chat
    • Webinars & Onboarding Calls
    • AI Assistant
    • FAQ
    • Importing Templates Guide
    • Test Templates
    • Live Eye Tracking Metrics
    • Mouse Tracking Demo
    • ChatGPT Demo
    • Audio Recording Object Demo
    • Adding Image Stimuli Demo
    • Score & Feedback Demo
    • Browse all technical demos →
    • Timing Precision
    • Stimuli Presentation
    • Headphone Checks
    • Bot Checks
    • Participant Management
    • Comparisons
    • Research Blog
    • Prolific Integration
    • CloudResearch Integration
    • Sona Systems Integration
    • BeSample Integration
    • Panelabs Integration
    • Clickworker Integration
    • Labvanced Webhook API
    • Labvanced REST API
    • About Us
    • Newsletter Archive
    • Terms & Conditions
    • Data Security & Data Privacy
    • Technical & Organisational Measures
    • Accessibility
    • W-8BEN-E Form
    • Data Processing Agreement Template
    LinkedInYouTubeDiscord
    • Individual
    • Lab
    • Department / Consortium
    • Teaching
    • Campus
    • Commercial
    • Browse recording top-ups →
    • Browse AI token top-ups →
    • Overview
    • Study Building
    • Subject Recruitment
    • Dedicated Support
    Checkout
  • Contact
    • EN
      • 中國人
      • Deutsch
      • Français
      • Español
      • English
      • 日本語
    • Logout
    • Loginlogin icon
    Platform
    Labvanced makes it easy to implement the most advanced study design and reliably collect your data.
    Biosignals & AI
    Remote Physiological MeasurementsEye TrackingHead & Face-TrackingEmotion DetectionHeart Rate Detection (rPPG)Generative AIAudio TranscriptionEEG & Hardware Integrations
    Behavioral Recordings
    Decision MakingReaction TimesKeyboard InputsMouse TrackingMobile / TouchQuestionnairesGamepad / Joystick Integration
    Media Recordings
    Audio RecordingsAudio TranscriptionVideo RecordingsScreen RecordingsPhotos / SnapshotsVideo ConferencingCanvas Drawings
    Implementation Techniques
    Build with AIBuild with SpreadsheetsUsing the Experiment EditorCodingCreating QuestionnairesBalancing & RandomizationUX & Website Testing
    Study Formats

    Your study can take whatever format your research needs. Here are a few popular examples.

    Single Session StudiesFactorial DesignsLongitudinal & Multi-session StudiesIndividual & Case StudiesReal-time Multi-user StudiesInterviews & Video CallsSurveys & QuestionnairesExperience Sampling & DiariesClassroom & Group TestingInterventions & Clinical Trials
    Where Studies Run

    Run your study online in the browser, on mobile or tablet with the mobile app, or in-lab with the desktop app.

    In the BrowserMobile AppDesktop AppWebBridge Chrome Extension
    Tests
    Explore cognitive tests, questionnaires, walkthroughs, and our public experiment library: a starting point for your next study.
    Popular Cognitive Tests
    Stroop TestFlanker TaskN-back TaskImplicit Association TestTrail Making TestDigit SpanCorsi Block TappingTower of LondonBalloon Analog Risk TaskPreferential Looking
    Browse more →
    Questionnaires & Scales
    DASS-21GAD-7Rosenberg Self-Esteem ScalePHQ-9Ten-Item Personality InventoryBig Five Personality TestAdult ADHD Self-Report Scale
    Browse more →
    Public Experiment Library

    Take a look at what other researchers in the community are doing through our extensive, open catalog of shared studies.

    Open the public library →
    Walkthroughs

    Step-by-step builds of complete studies, from a blank project to a running experiment, that you can follow along or adapt.

    Building a Multi-user StudyWebcam Eye Tracking with AOIsWebsite Frame Eye TrackingConditional Eye Tracking Opt-inChatGPT StudyDesktop App Study with EEGBetween-subjects Group BalancingBuilding a Reading StudyStroop TaskLexical Decision Task
    Browse more →
    Research
    One platform for students, academics, and industry researchers studying human behavior.
    Harvard UniversityStanford UniversityCambridge UniversityUCLNYUMax Planck InstituteUCLATU Munich

    Trusted by researchers at 1,500+ universities worldwide

    Academic Research
    Arts ResearchClinical Psychology & Neuropsychology MedicineCognitive PsychologyDevelopmental PsychologyBehavioral Economics & Decision ScienceEducational Research & PsychologyHCI & Human FactorsLinguistics & Language SciencesConsumer & Marketing ResearchSocial & Personality PsychologySport & Movement ScienceUX & Website Testing
    Research Areas
    Executive FunctionsLanguage & ReadingDecision-Making & ReasoningAttention
    Industry / Commercial
    OverviewHCI & Human FactorsUX & Website TestingConsumer & Marketing ResearchWhite-Label AppPageGazer
    Researcher Interviews

    Conversations with researchers about the studies they ran with Labvanced, what worked, and what they learned.

    Webcam vs. Lab Eye Tracking in InfantsAnna Banki & Gabriela MarkovaEye Tracking for Influencer MarketingDr. Alexander EdelingEye Tracking Infant Word ComprehensionDr. Giulia CalignanoSentence Reading and Grammar JudgmentsDr. Jonathan MiraultRegulating Emotions with MusicDr. Katrin StarckeGame-Based Grammar Learning in ChildrenDr. Mireia MarimonGaze Cueing and AutismMax Soares MiehsteinPersonality and Hearing in NoiseDr. Malte Wöstmann
    All interviews →
    Our Research
    Lab NotesHow to Cite Labvanced
    Peer Reviewed Studies

    A selection of peer-reviewed work built on Labvanced: our own platform and validation papers, and studies by the research community grouped by area. Hundreds more are listed on the full publications page.

    Labvanced Platform Paper (2017)Webcam Eye Tracking Validation (2024)Webcam Eye Tracking StudiesCognitive Psychology StudiesDevelopmental Psychology StudiesLinguistics Studies
    See all publications →
    Resources
    Valuable resources to help you learn the platform, stay updated, and more.
    Documentation
    Getting StartedGuideVideo TutorialsWalkthroughs
    Support
    Live ChatWebinars & Onboarding CallsAI AssistantFAQ
    Templates & Demos

    These are a few popular examples. Browse our guide and a selection of technical demos to get started with implementation.

    Importing Templates GuideTest TemplatesLive Eye Tracking MetricsMouse Tracking DemoChatGPT DemoAudio Recording Object DemoAdding Image Stimuli DemoScore & Feedback Demo
    Browse all technical demos →
    Methodology
    Timing PrecisionStimuli PresentationHeadphone ChecksBot ChecksParticipant ManagementComparisonsResearch Blog
    Integrations & APIs
    Prolific IntegrationCloudResearch IntegrationSona Systems IntegrationBeSample IntegrationPanelabs IntegrationClickworker IntegrationLabvanced Webhook APILabvanced REST API
    Company & Legal
    About UsNewsletter ArchiveTerms & ConditionsData Security & Data PrivacyTechnical & Organisational MeasuresAccessibilityW-8BEN-E FormData Processing Agreement Template
    LinkedInYouTubeDiscord
    Pricing
    Our licenses and additional services at a glance.
    Licenses
    IndividualLabDepartment / ConsortiumTeachingCampusCommercial
    Top-Ups

    Need more recordings for your lab or your own research? Simply use one of these recording top-up packages.

    Browse recording top-ups →

    Need more AI tokens for the AI assistant and study translations? Simply use one of these AI token top-up packages.

    Browse AI token top-ups →
    Additional Services

    Hire Labvanced’s expert team to quickly bring your project to the level of rigor it needs.

    OverviewStudy BuildingSubject RecruitmentDedicated Support
    Checkout

    Ready to purchase a license or top-up? Head straight to checkout.

    Go to checkout →
    • 中國人
    • Deutsch
    • Français
    • Español
    • English
    • 日本語
    • Getting Started
    • Guide
      • GETTING STARTED

        • Task Editor
        • Frames
          • Canvas Frame
          • Page Frame
          • Website Frame
          • Overlays & Dialogs | Labvanced
        • Trial Timeline
        • Stimulus Presentation
        • Correctness of Response
        • Objects
        • Events
        • Variables
        • Task Wizard
        • AI Assistant
        • Trial System
        • Experiment Design
          • Creating a Study
          • Importing Templates in Labvanced
          • Data Frame Patterns
          • Multi-user Experiment Design
          • Longitudinal Experiment Design
      • FEATURED TOPICS

        • Randomization & Balance
        • Eye Tracking
          • Presenting Stimuli in an Eye Tracking Task
          • How to Choose Eye Tracking Calibration Settings
          • Setting Up Eye Tracking in a Task
          • Recording and Exporting Gaze Data
          • Using Shapes as Areas of Interest (AOI) for Eye Tracking
          • The Participant Calibration Experience
        • Web Bridge
          • Selecting Website AOIs | Anchor, Adjust, and Verify AOI Tracking
          • Tracking Mouse Behavior on a Website AOI | Web Bridge Guide
        • 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
          • Frame Types
          • Objects
          • Object Property Tables
          • Variables
          • System Variables Table
          • The Event System
          • Text Editor Functions
          • Eye Tracking Options in the Task Editor
          • Head Tracking in a Task
          • Multi-User Studies
        • Settings
        • Variables
        • Media
        • Texts & Translate
        • Launch & Participate
        • Subject Management
        • Dataview and Export
    • Video Tutorials
      • 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
      • Building a Multi-user Study
      • Website Frame Eye Tracking Walkthrough
      • Conditional Webcam Eye Tracking
      • Text Segmentation Study Building
      • Building a Study with AI
    • FAQ
      • Features
      • Support Policy & Guidelines
      • Security & Data Privacy
      • Licensing
      • Precision of Labvanced
      • Programmatic Use & API
      • Using Labvanced Offline
      • Troubleshooting
      • Study Creation Questions

    Overlays & Dialogs

    Overlays and dialogs are frames that sit on top of your experiment and stay on screen while the frames and trials underneath change. A normal frame lives in the trial timeline: it appears when the trial reaches it and disappears when the trial moves on. An overlay or dialog lives outside the timeline. It is mounted for as long as its scope lasts (one trial, one task or the whole session), and events can show or hide it at any time.

    Table of Contents

    • Adding an Overlay or Dialog
    • Opening the Settings
    • Type, Scope and Initial State
    • Overlay Style
    • Dialog Style and Interaction
    • Scope
    • Events on Overlays and Dialogs
    • Showing and Hiding with Control Frame
    • Common Use Cases

    There are two types:

    • Overlay: layered on top of the experiment. Participants keep using the experiment underneath, and only the objects on the overlay catch clicks. Use it for a timer, a score or progress display, a help button, or any element that should stay visible between trials.
    • Dialog: a popup window above the experiment. By default it blocks and dims the experiment behind it until it is closed. Use it for help texts, instructions in the middle of a task, confirmations or conditional messages.

    Creating overlays and dialogs needs the Overlays & Dialogs license feature, which is included from the Basic license tier. With a Free license, clicking Canvas or Page in the Overlays & Dialogs tab opens the license upgrade dialog.

    Adding an Overlay or Dialog

    1. Open a task in the task editor.
    2. In the panel below the frame, click the Overlays & Dialogs tab (next to Trial Timeline).
    3. Click Canvas or Page.

    The two buttons start with different defaults. You can change all of them afterward.

    Added withTypeInitial stateOther defaultsDefault name
    CanvasOverlayShownMatch task display sizing, Transparent (see-through) fillOverlay_1, Overlay_2, and so on
    PageDialogHiddenCentered placement, blocks and dims the experiment behind it, can be dragged, with a close buttonDialog_1, Dialog_2, and so on

    Both start with the scope This task. The new frame is selected, and you edit it like any canvas frame or page frame: add objects from the toolbar, arrange them, and add frame events. The tab offers Canvas and Page only, so a website frame cannot be added as an overlay.

    To delete an overlay or dialog, use the Delete Frame icon on its entry in the Overlays & Dialogs panel.

    Opening the Settings

    Select the overlay or dialog in the Overlays & Dialogs panel. The Frame Settings panel (the Page Settings panel for a page) then shows a summary bar, for example Overlay · task · match task, with a gear icon. Click it to open the settings popout. Close the popout with the ✕ in its header or by clicking outside it.

    The frame settings Duration, Color and Hide Mouse are not shown for overlays and dialogs. They never advance on their own, their background color is set in the popout, and the mouse cursor is controlled by the frame underneath.

    Type, Scope and Initial State

    The Type group of the popout:

    SettingOptionsNotes
    TypeOverlay (layered on top), Dialog (popup window)Can be changed at any time. The Style group changes with it.
    ScopeThis trial, This task, Whole sessionHow long the frame stays mounted. See Scope. A Whole session overlay is listed in the Overlays & Dialogs panel of every task.
    Initial stateShown, HiddenWhether the frame is visible when it is mounted. Choose Hidden if an event should show it later.
    Also run trial events on itCheckbox, off by defaultLeave it off unless you need it. When it is on, the trial events of the task run on the frame underneath and on the overlay, so they can fire twice. A toggle would then switch straight back.

    Overlay Style

    These settings appear when Type is Overlay (layered on top).

    SettingOptionsNotes
    SizingMatch task display (sits on the frames), Floating (place it yourself)Match task display renders the overlay exactly like a frame of the task, so objects on it line up with objects on the frames underneath when both frames have the same size. Floating places the overlay box yourself.
    Anchor (floating only)Top left, Top center, Top right, Middle left, Center, Middle right, Bottom left, Bottom center, Bottom rightThe corner, edge or center of the screen the box is attached to. Default Top left.
    Offset X / Y (floating only)Two numbers, in pixelsDistance from the anchor. Default 20 and 20.
    FillTransparent (see-through), Solid color, Semi-transparentThe background of the overlay. Default Transparent (see-through).
    Color (solid and semi-transparent)Color pickerThe fill color.
    Opacity (semi-transparent only)Slider from 5% to 100%Default 50%.

    A floating canvas overlay takes its size from the frame's own Width and Height in the frame settings. A floating overlay made from a page uses a box of 500 by 350 pixels.

    Overlays never block the experiment. Empty, transparent areas let clicks through to the frame underneath, and only the objects on the overlay catch them.

    Dialog Style and Interaction

    These settings appear when Type is Dialog (popup window).

    Style

    SettingOptionsNotes
    PlacementCentered, Pinned to a spotCentered places the dialog in the middle of the screen.
    Anchor (pinned only)The same nine positions as for overlaysThe dialog keeps a distance of 20 pixels from the chosen corner or edge.
    Size W / H (page dialogs)Two numbers, in pixelsDefault 500 and 350. Pages have no designed size, so the dialog needs one.
    Size (canvas dialogs)Shown as "uses the frame's width & height"The dialog uses the frame's Width and Height, scaled down with the same aspect ratio if it would not fit the window.
    BackgroundColor pickerThe dialog background.
    BorderNone, SolidDefault Solid.
    Rounded cornersCheckbox, on by default
    Drop shadowCheckbox, on by default
    Title barCheckbox, off by defaultAdds a bar across the top of the dialog.
    Title (with title bar)TextThe text in the title bar.
    Close buttonCheckbox, on by defaultAn ✕ the participant can click to close the dialog. It sits in the title bar, or in the top right corner of the dialog when there is no title bar.

    Interaction

    SettingDefaultNotes
    Block the experiment behindOnParticipants cannot click the experiment while the dialog is open.
    Dim the experiment behindOnDarkens the experiment behind the dialog.
    Participant can drag itOnLets the participant move the dialog.
    Close when clicking outsideOffCloses the dialog when the participant clicks next to it.
    Close on Esc keyOffCloses the dialog when the participant presses Esc.

    Closing a dialog hides it and keeps it mounted, so its state persists for the next time it is shown.

    Scope

    Scope decides when an overlay or dialog is mounted and when it is removed.

    ScopeMountedRemovedUse for
    This trialWhen the task starts, then mounted again fresh at the start of every trialWhen the task endsPer-trial feedback or help that should start from scratch in each trial
    This taskWhen the task startsWhen the task endsTimers, score or progress displays, and help that belongs to one task
    Whole sessionWhen the first task startsWhen the session endsElements that should stay across all tasks, such as a help or pause button

    A This trial overlay is reset at the start of each trial, so its objects and their state start over. This task and Whole session overlays keep their state across trials and tasks. Variables are shared with the rest of the experiment in every scope, so a score variable shown on an overlay keeps its value.

    Overlays and dialogs always use the values of the default trial. They do not change per condition.

    Events on Overlays and Dialogs

    An overlay or dialog runs its own frame events, like any frame. They start each time it is shown and stop when it is hidden. Keyboard triggers on an overlay also work while the frame underneath is running.

    The trial events of the task (Trial Event (on each frame)) do not run on overlays and are not listed in their event panel, unless Also run trial events on it is checked.

    Showing and Hiding with Control Frame

    Use the Control Frame action to show, hide or toggle an overlay or dialog. You find it in the add action menu under Control Actions.

    1. Open the event editor on a frame in your trial timeline, or on the overlay itself.
    2. Add an event with any trigger.
    3. Add the action Control Frame.
    4. In Frame:, choose the overlay or dialog. The list shows the overlays and dialogs of all tasks plus those with Whole session scope.
    5. In Command:, choose Show, Hide or Toggle.

    If no overlay or dialog exists yet, the action shows a hint to add one in the Overlays & Dialogs tab. An action that targets a This task or This trial overlay of another task has no effect, because that overlay is only mounted while its own task runs. Two Toggle commands within a quarter of a second count as one, so a trigger that fires twice does not open and immediately close the dialog.

    Example: show a hidden help dialog when a button is clicked

    Trigger: Mouse → Set Target: your help button → Click
    Action: Control Frame → Frame: your help dialog → Command: Show

    Example: close the dialog from a button inside it

    On the dialog frame:
    Trigger: Mouse → Set Target: its Continue button → Click
    Action: Control Frame → Frame: the same dialog → Command: Hide

    Common Use Cases

    Timer across trials: Add a Canvas overlay with the scope This task, set Sizing to Floating (place it yourself) and Anchor to Top right, and place a Timer Object on it. Start the timer with an On Frame Start event on the overlay. It keeps running across frame and trial jumps until the task ends.

    Score or progress display: Add a Canvas overlay with Match task display and a Variable object (toolbar group Text & Code) that shows your score variable. Variables are shared, so the display updates whenever an event on the frames underneath changes the score.

    Help dialog: Add a Page dialog, hidden by default, with your instructions, and a help button on a This task overlay or on the frames themselves. A Control Frame action with the command Show opens the dialog, and the participant closes it with the close button.

    Pause message across tasks: Add a Page dialog with the scope Whole session and Initial state set to Hidden. Show it with Control Frame at the end of a task, and hide it with a Continue button inside the dialog. For a regular break between blocks, a normal page frame in the trial timeline is often simpler.

    Further Reading

    Trial Timeline

    Trial Timeline

    How frames are added and ordered within a trial, and how frame settings work.

    Event System

    Event System

    Triggers and actions, including the Control Frame action that shows and hides overlays and dialogs.

    Working with Variables

    Working with Variables

    Variables are shared between overlays and the frames underneath, which is how a score or a state travels between them.

    Prev
    Website Frame