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, Microsoft Edge, Brave, Opera, Naver Whale, Yandex Browser, Chromium, Patchright, Rebrowser, Camoufox, Firefox, WebKit.
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
- Keep the files a session downloads, fetch them afterwards
All options: launch options.