--- title: "Scroll the page in a web test" sidebarTitle: "Scroll" description: "Scroll a web page until an element is visible, before interacting with content below the fold or checking that lazy-loaded sections load." lastUpdated: "2026-09-23" --- > **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version. 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 | Parameter | Required | Description | | ----------- | ---------- | ------------- | | Target element | Yes, unless a manual selector is set | Natural-language description of the element to scroll to. | | Manual selector | No | XPath or CSS selector, used when AI is disabled or as the saved selector. | | Scroll behavior | No | `auto` (default), `smooth`, or `instant`. | | Vertical placement | No | Where the element lands vertically: `start`, `center` (default), `end`, or `nearest`. | | Horizontal placement | No | Where the element lands horizontally: `start`, `center` (default), `end`, or `nearest`. | | AI usage | No | `inherit` (default, follows the test strategy), `smart`, or `always`. | | Ignore error on this step | No | The 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? Interact with the element you scrolled to Check that the lazy-loaded content appeared