Scroll the page in a web test

Scroll a web page until an element is visible, before interacting with content below the fold or checking that lazy-loaded sections load.

Scroll the page until an element is visible. Use it before interacting with content below the fold, or to verify lazy-loaded sections actually load when reached.

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