> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spurtest.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scroll

> Learn how to use scroll actions in Spur

The scroll action allows you to navigate through content by moving vertically or horizontally on a webpage.

## Basic Usage

Scroll vertically and horizontally using natural language.

<Frame caption="Scrolling Vertically">
  <img src="https://mintcdn.com/spur/qv5cvlrqcbi1P9nN/images/Scroll/scroll_ex_1.png?fit=max&auto=format&n=qv5cvlrqcbi1P9nN&q=85&s=f1ad176039ddc77291a2ae7366bc0d87" alt="" width="1042" height="152" data-path="images/Scroll/scroll_ex_1.png" />
</Frame>

<Frame caption="Scrolling Horizontally">
  <img src="https://mintcdn.com/spur/qv5cvlrqcbi1P9nN/images/Scroll/scroll_ex_2.png?fit=max&auto=format&n=qv5cvlrqcbi1P9nN&q=85&s=ea27e66c9b0d82b5a74c2fee741b58b8" alt="" width="1044" height="120" data-path="images/Scroll/scroll_ex_2.png" />
</Frame>

## For Inner Scrolls

For scrollable containers within a page, first hover on the container, then scroll. You can also describe the inner scroll directly:

```
Scroll up in the chat history to view the results
```

<Frame caption="First Hover on the scrollable container, then Scroll">
  <img src="https://mintcdn.com/spur/qv5cvlrqcbi1P9nN/images/Scroll/scroll_ex_3.png?fit=max&auto=format&n=qv5cvlrqcbi1P9nN&q=85&s=e94895fad4934edb848cf0f39074c463" alt="" width="1040" height="236" data-path="images/Scroll/scroll_ex_3.png" />
</Frame>

## Scroll Until Visible

You can tell the agent to scroll until a specific element comes into view:

```
Scroll down until the "favorites" section is visible
```

This is useful when you need to reach a section of the page but don't know exactly how far to scroll.

## Scroll to Page Sections

You can tell the agent to scroll directly to the footer or header of a page:

```
Scroll down to the footer of the page
```

## Best Practices

The Spur agent decides how far to scroll based on your prompt. If the prompt is to scroll all the way to the bottom of the page, the agent will scroll by a larger amount (e.g. the entire viewport).

<Tip>
  For more reliable tests, provide specific pixel values for scroll distances when precision matters.
</Tip>
