---
id: api/commands/scrollto
title: scrollTo | Cypress Documentation
description: Scroll to a specific position in the window or element in Cypress.
section: api
source_path: docs/api/commands/scrollto.mdx
version: a8fd16711bdda4c7b5645b9717e588ae99ec2470
updated_at: '2026-05-18T17:21:32.047Z'
---
# scrollTo

Scroll to a specific position.

It is [unsafe](/llm/markdown/app/core-concepts/retry-ability.md#Only-queries-are-retried) to chain further commands that rely on the subject after `.scrollTo()`.

## Syntax

```
cy.scrollTo(position)cy.scrollTo(x, y)cy.scrollTo(position, options)cy.scrollTo(x, y, options)  // ---or---  .scrollTo(position)  .scrollTo(x, y)  .scrollTo(position, options)  .scrollTo(x, y, options)
```

### Usage

**Correct Usage**

```
cy.scrollTo(0, 500) // Scroll the window 500px downcy.get('.sidebar').scrollTo('bottom') // Scroll 'sidebar' to its bottom
```

**Incorrect Usage**

```
cy.title().scrollTo('My App') // Errors, 'title' does not yield DOM element
```

### Arguments

**position _(String)_**

A specified position to scroll the window or element to. Valid positions are `topLeft`, `top`, `topRight`, `left`, `center`, `right`, `bottomLeft`, `bottom`, and `bottomRight`.

**x _(Number, String)_**

The distance in pixels from window/element's left or percentage of the window/element's width to scroll to.

**y _(Number, String)_**

The distance in pixels from window/element's top or percentage of the window/element's height to scroll to.

**options _(Object)_**

Pass in an options object to change the default behavior of `cy.scrollTo()`.

| Option | Default | Description |
| --- | --- | --- |
| `duration` | `0` | Scrolls over the duration (in ms) |
| `easing` | `swing` | Will scroll with the easing animation |
| `ensureScrollable` | `true` | Ensure element is scrollable. Error if element cannot scroll. |
| `log` | `true` | Displays the command in the [Command log](/llm/markdown/app/core-concepts/open-mode.md#Command-Log) |
| `timeout` | [`defaultCommandTimeout`](/llm/markdown/app/references/configuration.md#Timeouts) | Time to wait for `.scrollTo()` to resolve before [timing out](#Timeouts) |

### Yields [Learn about subject management](/llm/markdown/app/core-concepts/introduction-to-cypress.md#Subject-Management)

*   `.scrollTo()` yields the same subject it was given.
*   It is [unsafe](/llm/markdown/app/core-concepts/retry-ability.md#Only-queries-are-retried) to chain further commands that rely on the subject after `.scrollTo()`.

## Examples

### Position

#### Scroll to the bottom of the window

```
cy.scrollTo('bottom')
```

#### Scroll to the center of the list

```
cy.get('#movies-list').scrollTo('center')
```

### Coordinates

#### Scroll 500px down the list

```
cy.get('#infinite-scroll-list').scrollTo(0, 500)
```

#### Scroll the window 500px to the right

```
cy.scrollTo('500px')
```

#### Scroll 25% down the element's height

```
cy.get('.user-photo').scrollTo('0%', '25%')
```

### Options

#### Use linear easing animation to scroll

```
cy.get('.documentation').scrollTo('top', { easing: 'linear' })
```

#### Scroll to the right over 2000ms

```
cy.get('#slider').scrollTo('right', { duration: 2000 })
```

#### Do not error if element is not scrollable

Let's say we do not know whether our `table` element is scrollable. Sometimes the `table` may be scrollable (with 2,000 rows) and sometimes the `table` may not be scrollable (with 5 rows). You can ignore the error checking to ensure the element is scrollable by passing `ensureScrollable: false`.

```
// will move on to next command even if table is not scrollablecy.get('table').scrollTo('bottom', { ensureScrollable: false })cy.get('table').find('tr:last-child').should('be.visible')
```

## Notes

### Actionability

`cy.scrollTo()` is an "action command" that follows all the rules of [Actionability](/llm/markdown/app/core-concepts/interacting-with-elements.md).

### Scopes

`cy.scrollTo()` acts differently whether it's starting a series of commands or being chained off of an existing.

#### When starting a series of commands:

This scrolls the `window`.

```
cy.scrollTo('bottom')
```

#### When chained to an existing series of commands:

This will scroll the `<#checkout-items>` element.

```
cy.get('#checkout-items').scrollTo('right')
```

### Snapshots

#### Snapshots do not reflect scroll behavior

_Cypress does not reflect the accurate scroll positions of any elements within snapshots._ If you want to see the actual scrolling behavior in action, we recommend using [`.pause()`](/llm/markdown/api/commands/pause.md) to walk through each command or [watching the video of the test run](/llm/markdown/app/guides/screenshots-and-videos.md#Videos).

## Rules

### Requirements [Learn about chaining commands](/llm/markdown/app/core-concepts/introduction-to-cypress.md#Chains-of-Commands)

*   `.scrollTo()` requires being chained off a command that yields DOM element(s).
*   `.scrollTo()` requires the element to be scrollable.

### Timeouts [Learn about timeouts](/llm/markdown/app/core-concepts/introduction-to-cypress.md#Timeouts)

*   `.scrollTo()` can time out waiting for assertions you've added to pass.

## Command Log

**_Scroll to the bottom of the window then scroll the element to the "right"_**

```
cy.scrollTo('bottom')cy.get('#scrollable-horizontal').scrollTo('right')
```

The commands above will display in the Command Log as:

When clicking on `scrollTo` within the command log, the console outputs the following:

## History

| Version | Changes |
| --- | --- |
| [4.11.0](/llm/markdown/app/references/changelog.md#4-11-0) | Added support for `ensureScrollable` option. |

## See also

*   [`.scrollIntoView()`](/llm/markdown/api/commands/scrollintoview.md)