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

> ## Agent Instructions
> Setting up Context.dev for a user? Follow https://docs.context.dev/agent-quickstart.md. MCP clients sign in with OAuth and need no API key; application code reads CONTEXT_DEV_API_KEY.

# Waiting and rendering

> Control page readiness, viewport size, theme, and popup handling.

Put rendering options inside `sharedParams`. Waiting happens after browser actions and before output capture.

## Wait for a page element

Send this body to `POST /web/scrape`. See the [Quickstart](/quickstart) for authentication and SDK setup.

```json theme={null}
{
  "url": "https://example.com",
  "formats": {
    "markdown": true,
    "screenshot": true
  },
  "sharedParams": {
    "waitFor": "main",
    "viewport": {
      "width": 1280,
      "height": 800
    }
  }
}
```

## Options

| Field | Default | Behavior |
| - | - | - |
| `waitFor` | 500 ms | Milliseconds (0–30,000) or a CSS selector. Defaults to 2,000 ms with frames or an XML URL. `0` skips the wait. |
| `settleAnimations` | `true` with screenshots | Wait for CSS animations to settle. Otherwise defaults to `false`. |
| `viewport` | 1920 × 1080 when omitted | Width 240–7,680; height 240–4,320. |
| `theme` | Browser default | `light` or `dark`. |
| `dismissCookies` | `true` | Accept detected cookie banners. |
| `dismissPopups` | `false` | Close other detected popups. |

An explicitly empty `viewport: {}` uses field defaults of 1440 × 900. Set both dimensions when the size matters.

## Mobile and consent views

For mobile rendering, use `viewport: {"width":390,"height":844}`. To keep a consent banner visible, set `dismissCookies: false` and leave `dismissPopups` false. Popup handling is heuristic and may not remove every overlay.

Choose selector waits when a specific element indicates readiness. Fixed waits count toward the [timeout budget](/scrape/timeouts-and-errors). Content can still be incomplete when page rendering does not settle; inspect `isPartial` and each output’s `success`.