> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.doc-detective.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.doc-detective.com/_mcp/server.

# Swipe (directional)

> Reference for the `Swipe (directional)` schema.

## Referenced In

* [swipe](/reference/schemas/swipe)

## Fields

| Field     | Type                                                                                                                                     | Description                                                                                                                                                                                                                                                                                                                                                      | Default |
| :-------- | :--------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------ |
| direction | string                                                                                                                                   | Required. Direction the virtual finger moves. `up` reveals content below; `left` reveals content to the right (for example, the next carousel card). Accepted values: `up`, `down`, `left`, `right`                                                                                                                                                              | —       |
| distance  | number                                                                                                                                   | Optional. How far to swipe, as a fraction of the surface's height (for up/down) or width (for left/right). Exclusive minimum: 0. Maximum: 1                                                                                                                                                                                                                      | `0.5`   |
| duration  | integer                                                                                                                                  | Optional. Duration of the swipe movement in milliseconds. Minimum: 1                                                                                                                                                                                                                                                                                             | `500`   |
| surface   | one of: - string - object([Browser surface](/reference/schemas/browser-surface)) - object([App surface](/reference/schemas/app-surface)) | Optional. The browser window/tab or app window this step acts on. Omit to act on the active surface — the most recently opened, focused, or explicitly targeted surface, whatever its kind (a background process can't be swiped). Specifying a surface switches the active surface for the steps that follow. App surfaces use the object form (\{ "app": … }). | —       |

## Examples

```json
{
  "direction": "up",
  "distance": 0.5,
  "duration": 500,
  "surface": "chrome"
}
```