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
    Timer Object displayed on a Labvanced experiment frame showing a countdown timer in MM:SS format

    Timer Object

    The Timer Object displays a visible countdown or count-up timer on screen during a trial. It integrates fully with the Labvanced event system: you control the timer using StartTimer, PauseTimer, and ResetTimer actions, and it fires triggers when it starts, pauses, ends, or crosses a whole-second boundary. The current time value is available as a readable and writable variable, making it straightforward to branch experiment logic based on elapsed or remaining time.

    Table of Contents

    • Adding the Timer Object
    • Timer Setup Wizard
    • Object Properties
    • Controlling the Timer with Actions
    • Triggering Events from the Timer
    • Using Current Time as a Variable

    Adding the Timer Object

    In the task editor toolbar, open the Buttons & Navigation group and select Timer to add a Timer Object to the current frame.

    Labvanced task editor toolbar with the Timer Object highlighted in the Buttons & Navigation group

    When you add the element, a Timer Setup Wizard opens automatically. You can complete the wizard to pre-configure the timer and add common events in one step, or click Skip to configure everything manually.

    Timer Setup Wizard

    The setup wizard covers the most common configuration choices and can optionally add starter events for you.

    Timer Setup Wizard dialog showing Duration, Directionality, Display, and Add These Events settings
    OptionDescription
    Timer Duration (seconds)Sets how long the timer runs. Enter a positive integer. Default is 60 seconds.
    DirectionalityCount down starts at the duration and counts toward 0. Count up starts at 0 and counts toward the duration.
    Show tenths of a secondWhen checked, the timer displays in MM:SS.T format instead of MM:SS.
    Start timer on frame startAdds an event that fires StartTimer automatically when the frame begins.
    Jump to next frame when timer endsAdds an event that fires Jump to Next Frame when the TimerEnded trigger fires.

    You can skip any of the auto-events and configure them manually in the event editor instead.

    Object Properties

    All settings below are found in the Object Properties panel when the Timer Object is selected.

    Timer settings

    PropertyDefaultDescription
    Duration (seconds)60The total duration the timer runs for, in seconds.
    DirectionalityCount downCount down starts at the duration and counts toward 0. Count up starts at 0 and counts toward the duration.
    Show tenths of a secondOffWhen enabled, the timer displays in MM:SS.T format. When off, it displays in MM:SS format. Not modifiable via events at runtime.

    Note: Current Time (seconds) does not appear in the Properties panel, but it is readable and writable at runtime via the Set Object Property action in the event system. See Using Current Time as a Variable.

    Object Properties panel for a Timer Object showing Duration, Current Time, and Counts Up fields

    Style

    PropertyWhat it controls
    VisibilityOpacity from 0 (invisible) to 1 (fully visible).
    Border-SizeBorder width in pixels. Default is 0 (no border).
    Border-ColorBorder color. Has no visible effect when Border-Size is 0.
    BG-ColorBackground fill of the bounding box. Enable Transparent to remove the fill.
    RoundnessCorner rounding from 0 (sharp corners) to 1 (maximum rounding: an ellipse on rectangular elements, a circle on square elements).

    Custom CSS

    Check Change CSS Properties in the Style section to reveal the CSS textarea. Write standard CSS rules there. Labvanced automatically scopes each rule to the selected object, so your selectors only affect that element's internal DOM.

    Styling the time display

    Target span to change the font, color, size, or weight of the time readout:

    span {
      font-size: 3em !important;
      color: #c0392b;
      font-family: "Courier New", monospace;
      font-weight: bold;
      letter-spacing: 0.05em;
    }
    

    Timer Object with custom CSS applied showing styled font and container
    Modifications to the Timer Object style via CSS using the Object Properties panel.

    Note on property precedence

    Background color, border, and border-radius set in the Style panel are applied as inline styles on the element, which take precedence over custom CSS rules. If you need custom CSS to override a Style panel value, add !important to your rule. For these three properties, using the Style panel controls is generally simpler.

    Controlling the Timer with Actions

    Use the Control Media Object action in the event system to control the timer programmatically.

    ActionWhat it does
    StartTimerStarts the timer from its current position. If the timer was paused, it resumes from where it stopped.
    PauseTimerPauses the timer at its current position without resetting it.
    ResetTimerStops the timer and resets Current Time to its starting position: duration for count-down, 0 for count-up.

    Example: start the timer automatically when the frame begins

    Trigger: On Frame Start
    Action: Control Media Object → Set Target: your Timer Object → StartTimer

    Example: pause the timer when a button is clicked

    Trigger: On Mouse Click → Set Target: your pause button
    Action: Control Media Object → Set Target: your Timer Object → PauseTimer

    Triggering Events from the Timer

    The Timer Object fires the following triggers, which you can use as the "when" condition in any event.

    TriggerWhen it fires
    TimerStartedWhen StartTimer is called and the timer begins running.
    TimerPausedWhen PauseTimer is called and the timer stops.
    TimerEndedWhen the timer reaches its end: 0 for count-down, or the duration for count-up.
    TimerThresholdFires once each time the timer crosses a whole-second boundary while running. Use this to execute logic at regular one-second intervals.

    Example: advance to the next frame when the timer ends

    Trigger: Media Object Trigger → Set Target: your Timer Object → Execute on: TimerEnded
    Action: Jump to Next Frame

    Example: record a variable every second

    Trigger: Media Object Trigger → Set Target: your Timer Object → Execute on: TimerThreshold
    Action: Set / Record Variable → your recording variable

    Using Current Time as a Variable

    The Current Time (seconds) property is a readable and writable runtime value. You can use the Set Object Property action to read the current time into another variable, or to seek the timer to a specific position.

    This makes it possible to:

    • Record the exact time remaining when a participant responds
    • Branch experiment flow based on how much time has elapsed
    • Synchronize two timers by writing the same value to both

    Example: record time remaining at response

    Trigger: On Key Press → Set Target: your target key
    Action 1: Set / Record Variable → create a variable (e.g. time_at_response), value source: Object Property → Set Target: your Timer Object → Current Time (seconds)
    Action 2: Jump to Next Frame

    Event setup with a Set / Record Variable action reading the Current Time value from a Timer Object

    Further Reading

    Illustration of the event system in Labvanced, used to wire StartTimer, PauseTimer, and ResetTimer actions

    Event System

    How triggers and actions are structured in Labvanced. Essential for wiring StartTimer, PauseTimer, and ResetTimer actions and responding to TimerEnded or TimerThreshold triggers.

    Working with Variables

    Working with Variables

    How to create, configure, and record variables. Covers the recording options you need when reading Current Time into a response variable.

    All Objects

    All Objects

    A full index of all objects available in the Labvanced experiment editor, including display, input, media, and recording elements.