Skip to main content
Version: v2.3.0

Device Restrictions

ReVISit lets you set a minimum screen size for your study to make sure participants have enough space to view the content and complete tasks. If their screen is too small, they’ll see a message asking them to resize their browser window or switch to a larger device.

Setting Screen Size Requirements​

You can specify minimum screen dimensions in the uiConfig section of your study configuration file by setting the minWidthSize and minHeightSize properties. These values are measured in pixels.

{
  "uiConfig": {
    "contactEmail": "contact@revisit.dev",
    "helpTextPath": "demo-html/assets/help.md",
    "logoPath": "revisitAssets/revisitLogoSquare.svg",
    "withProgressBar": true,
    "autoDownloadStudy": false,
    "withSidebar": true,
    "windowEventDebounceTime": 200,
    "minHeightSize": 800,
    "minWidthSize": 400
  }
}

How It Works​

When a participant starts the study, reVISit checks whether their browser window meets the minimum screen size requirements. If the screen is too small, a warning screen appears with a one-minute countdown timer showing the current and required dimensions.

Device Size Check Timer

The participant has one minute to resize their browser window. During this time, reVISit continuously monitors the window size. Once both the width and height meet the requirements, the warning disappears and the study begins.

If the timer runs out and the screen is still too small, the participant will see a training failed page and will not be able to continue the study.

Device Size Check Timeout

In the participant table, the participant will be listed as rejected with the reason "Screen resolution too small."

Device Size Check Rejected Participant