---
id: api/commands/reload
title: reload | Cypress Documentation
description: Reload the page in Cypress.
section: api
source_path: docs/api/commands/reload.mdx
version: 204dffbf7fbb64b1fe8343a54ddcd869cc275f1f
updated_at: '2026-05-12T20:33:17.938Z'
---
# reload

Reload the page.

## Syntax

```
cy.reload()cy.reload(forceReload)cy.reload(options)cy.reload(forceReload, options)
```

### Usage

**Correct Usage**

```
cy.reload()
```

### Arguments

**forceReload _(Boolean)_**

Whether to reload the current page without using the cache. `true` forces the reload without cache.

**options _(Object)_**

| Option | Default | Description |
| --- | --- | --- |
| `log` | `true` | Displays the command in the [Command log](/llm/markdown/app/core-concepts/open-mode.md#Command-Log) |
| `timeout` | [`pageLoadTimeout`](/llm/markdown/app/references/configuration.md#Timeouts) | Time to wait for `cy.reload()` to resolve before [timing out](#Timeouts) Note: Network requests are limited by the underlying operating system, and may still time out if this value is increased. |

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

*   `cy.reload()` yields the `window` object after the page finishes loading.
*   It is [unsafe](/llm/markdown/app/core-concepts/retry-ability.md#Only-queries-are-retried) to chain further commands that rely on the yielded `window` after `cy.reload()`.

## Examples

### No Args

#### Reload the page as if the user clicked 'Refresh'

```
cy.visit('http://localhost:3000/admin')cy.get('#undo-btn').click().should('not.be.visible')cy.reload()cy.get('#undo-btn').click().should('not.be.visible')
```

### Force Reload

#### Reload the page without using the cache

```
cy.visit('http://localhost:3000/admin')cy.reload(true)
```

## Rules

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

*   `cy.reload()` requires being chained off of `cy`.
*   `cy.reload()` requires the response to be `content-type: text/html`.
*   `cy.reload()` requires the response code to be `2xx` after following redirects.
*   `cy.reload()` requires the load `load` event to eventually fire.

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

*   `cy.reload()` will automatically wait for assertions you have chained to pass.

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

*   `cy.reload()` can time out waiting for the page to fire its `load` event.
*   `cy.reload()` can time out waiting for assertions you've added to pass.

## Command Log

**_Reload the page_**

```
cy.reload()
```

The commands above will display in the Command Log as:

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

## See also

*   [`cy.go()`](/llm/markdown/api/commands/go.md)
*   [`cy.visit()`](/llm/markdown/api/commands/visit.md)