[Launch options](https://cdpfleet.com/docs/options)

# `downloads`

Keep every file the browser downloads, to fetch after the session.

**Use it for:** Downloads you can't catch in code: a person clicking in live view or Launch interactive, an AI agent working through the MCP server, a script that crashed or disconnected (`keep_alive`), or reports and exports you want to collect later.

**Browsers:** [Google Chrome](https://cdpfleet.com/docs/browsers/chrome#opt-downloads), [Microsoft Edge](https://cdpfleet.com/docs/browsers/edge#opt-downloads), [Brave](https://cdpfleet.com/docs/browsers/brave#opt-downloads), [Opera](https://cdpfleet.com/docs/browsers/opera#opt-downloads), [Naver Whale](https://cdpfleet.com/docs/browsers/whale#opt-downloads), [Yandex Browser](https://cdpfleet.com/docs/browsers/yandex#opt-downloads), [Chromium](https://cdpfleet.com/docs/browsers/chromium#opt-downloads), [Patchright](https://cdpfleet.com/docs/browsers/patchright#opt-downloads), [Rebrowser](https://cdpfleet.com/docs/browsers/rebrowser#opt-downloads), [Camoufox](https://cdpfleet.com/docs/browsers/camoufox#opt-downloads), [Firefox](https://cdpfleet.com/docs/browsers/firefox#opt-downloads), [WebKit](https://cdpfleet.com/docs/browsers/webkit#opt-downloads).

## Details

-   **Type:** `boolean`
-   **Default:** false
-   **Example:** `{"downloads":true}`

With `true`, every file the browser downloads in this session is kept: after the session ends it appears under `GET /v1/me/downloads` and on the dashboard's Sessions page, for 2 days. Your own code still receives downloads as usual (`download.saveAs()` in Playwright).

Paid plans (`403 downloads_not_available` on Community). Up to 1 GB and 200 files per session, and 1 GB per account (the oldest files go first); kept 2 days. Not kept: downloads in contexts a raw-CDP client creates itself, and contexts opened with `acceptDownloads: false`. WebKit doesn't treat a `text/plain` response with `Content-Disposition: attachment` as a download.

## Used in

-   [Case 82: Kept downloads in practice: a person in Launch interactive and an AI agent over MCP](https://cdpfleet.com/docs/cases/downloads-in-practice)
-   [Keep the files a session downloads, fetch them afterwards](https://cdpfleet.com/docs/examples#downloads)

All options: [launch options](https://cdpfleet.com/docs/options).

---
Source: https://cdpfleet.com/docs/options/downloads · Markdown: https://cdpfleet.com/docs/options/downloads.md · All docs for AI tools: https://cdpfleet.com/llms.txt