Scroll the page in a web test

Scroll a web page until an element is in view, so later steps can reach content further down.

Use it before interacting with content that is not on screen yet, or to check that sections loading only when you reach them (lazy loading) actually show up. The placement settings decide where the element lands on screen.

Parameters

ParameterRequiredDescription
Target elementYes, unless a manual selector is setNatural-language description of the element to scroll to.
Manual selectorNoXPath or CSS selector, used when AI is disabled or as the saved selector.
Scroll behaviorNoauto (default), smooth, or instant.
Vertical placementNoWhere the element lands vertically: start, center (default), end, or nearest.
Horizontal placementNoWhere the element lands horizontally: start, center (default), end, or nearest.
AI usageNoinherit (default, follows the test strategy), smart, or always.
Ignore error on this stepNoThe run continues with the next step if this one fails. Default: off.

Results and metrics

  • Timing: start, end, and duration (in seconds) recorded in the step result.
  • Status: success, warning, or failed, with the error message on failure.
  • Screenshot: captured after the step runs, showing the new position.
  • AI usage: if the AI located the element, the healed selector is saved on the test and the AI cost is added to the run.

What's next?

Click

Interact with the element you scrolled to

Verify element

Check that the lazy-loaded content appeared

Last updated on