Designing Studies
Designing Forms
Form elements are essential for most studies to capture user responses. ReVISit provides rich form elements, such as sliders, checkboxes, text fields, etc., so that you can efficiently design your forms.
Templating with Variables
Some text fields in a study config can contain {} placeholders. When the study runs, each placeholder is replaced with a real value. This lets you reuse one component definition across many trials, and change small details (a name, a country, a number) per trial without copy-pasting the whole component.
Designing Image/Video Stimuli
Image and video stimuli are essential for most studies. They can be used to present visual information, such as charts, images, or videos, to participants. This tutorial provides an overview of how to use image and video stimuli in your study.
Designing an HTML Stimulus
Now, we will take the study we just created and add another component based on a user-created HTML file. This allows for some additional customization of the component.
Designing a React Stimulus
React is a popular JavaScript library for building user interfaces, primarily for single-page applications. You can find more details on the official React documentation.
Designing a Vega Stimulus
Vega and Vega-Lite are popular visualization grammars for creating data visualizations.
Declarative Study Design using Factors
Experiments typically involve a mixture of between- and within-subject conditions. In ReVISit version 3, we introduce factors to support the declaration of large sequences with between- and within-subject variables using an expressive, declarative syntax. In other words, you can think of factors as building blocks for creating complex experiment designs.
Responses and Answers
In reVISit, a component typically has a response that is recorded when a participant completes a task. Responses can be provided via form elements or via some other kind of payload through your custom component and a ReactiveResponse.
Study Browser
The Study Browser shows how a Study Config is structured and, when an Analyst views a Participant's data, how that Participant moved through the study. Hover over an indicator to view its details.
Sequences
3 items
Provenance Tracking
ReVISit integrates with Trrack, a state-based provenance tracking library maintained by the ReVISit team. For new studies, use ReVISit's managed Trrack APIs:
Think Aloud
ReVISit has integrated audio recording and audio playback for conducting in-person or crowdsourced think-aloud studies. Audio recording works with Firebase, Supabase, and local storage. With local storage, recordings remain in the participant's browser.
Record Screen and Webcam
ReVISit provides built-in support for screen and webcam recording and playback, enabling both in-person and crowdsourced tracking studies. You can record the screen, the webcam, or both. Audio recording can also be enabled for Think Aloud studies.
Preview and Export a Study Page
While previewing or taking a study, you can save the current page as a PDF. Open Study actions (the three-dot menu in the page header) and select Export page as PDF. ReVISit exports the current component as it is rendered, including visible response controls and any displayed selections. It does not export the full study or provide structured participant data.
Applying Styles
ReVISit provides flexible styling capabilities to customize the appearance of your study components and responses. You can apply styles at three levels: globally through UI configuration, at the component level, and at the response level.
Device Restrictions
ReVISit lets you control whether participants can enter a study based on screen size, browser version, device type, and input method.
ReVISit Libraries
We provide predefined libraries of study components and validated questionnaires for visualization and HCI. These libraries are easy to integrate into your study configurations as individual components or sequences of components.
Templating with Variables
Some text fields in a study config can contain {} placeholders. When the study runs, each placeholder is replaced with a real value. This lets you reuse one component definition across many trials, and change small details (a name, a country, a number) per trial without copy-pasting the whole component.
Global Variables
Use global variables when a Participant's choices should carry across trials: a remaining budget, a running score, a label, or an eligibility flag. Each Participant has their own values. Component parameters still describe a particular component; global variables hold values that can change during the study.
Parser Errors and Warnings
When ReVISit parses your Study Config, it checks for issues that could prevent the study from running correctly. Errors must be fixed before the study can run. Warnings identify potential problems but do not, by themselves, prevent the study from running. Errors are expanded and warnings are collapsed by default.