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

# `profile`

Restore a saved browser profile and save it again when the session ends.

**Use it for:** Staying logged in between sessions: log in once, then every later launch starts with the same cookies and storage (and, on Camoufox, the same device).

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

## Details

-   **Type:** `string | object`
-   **Default:** none
-   **Example:** `{"profile":"shop-login"}`

A name (`"shop-login"`, up to 64 letters, digits, `-`, `_`) or `{ "id": "shop-login", "mode": "readonly" }`. The first launch with a new name creates the profile; later launches restore its cookies, localStorage and IndexedDB, and the profile is saved when the session ends. Session cookies are kept too; sessionStorage (per tab) is not. Work in `browser.contexts()[0]` — a context made with `newContext()` is not saved. `"mode": "readonly"` restores without saving and can run in parallel; a second normal session gets `409 profile_in_use`. On Camoufox the device fingerprint is kept with the profile. See [Persistent profiles](https://cdpfleet.com/docs/profiles).

Every browser except Whale and Rebrowser. Keeps cookies (session cookies too), localStorage and IndexedDB; not sessionStorage. 20 profiles per shared thread and 30 per dedicated thread (at least 100), 50 MB each; list and delete with `/v1/me/profiles`.

## Used in

-   [Case 77: Kasada and AWS WAF on real sites: twelve browsers, four sites, one exit each](https://cdpfleet.com/docs/cases/kasada-and-aws-waf-by-browser)
-   [Case 75: HUMAN on real sites: twelve browsers, three sites, one exit each](https://cdpfleet.com/docs/cases/human-real-sites-by-browser)
-   [Case 73: Akamai on real sites: twelve browsers, three sites, one exit each](https://cdpfleet.com/docs/cases/akamai-real-sites-by-browser)
-   [Case 71: DataDome on real sites: twelve browsers, three sites, one exit each](https://cdpfleet.com/docs/cases/datadome-real-sites-by-browser)
-   [Case 70: Cloudflare on real sites: twelve browsers, three sites, one exit each](https://cdpfleet.com/docs/cases/cloudflare-real-sites-by-browser)
-   [Case 66: Which fingerprints stay the same across launches: canvas, WebGL, audio and fonts on seven browsers](https://cdpfleet.com/docs/cases/fingerprint-stability-across-launches)
-   [Case 67: Akamai and HUMAN: what gets through? Four browsers, three networks, the vendors' own sites](https://cdpfleet.com/docs/cases/akamai-and-human-what-gets-through)
-   [Case 65: DataDome: what gets through? Four browsers, three networks, DataDome's own site](https://cdpfleet.com/docs/cases/datadome-what-gets-through)
-   [Case 64: Cloudflare: what gets through? Four browsers, three networks, four public test pages](https://cdpfleet.com/docs/cases/cloudflare-what-gets-through)
-   [Case 49: The same Camoufox device across relaunches: what a persistent profile keeps, and what it doesn't](https://cdpfleet.com/docs/cases/camoufox-same-device)
-   [Case 40: Persistent profiles: what a saved browser profile keeps, and what it doesn't](https://cdpfleet.com/docs/cases/persistent-profiles)
-   [Chrome that stays logged in between sessions](https://cdpfleet.com/docs/examples#chrome-profile)
-   [Camoufox that keeps the same device and login](https://cdpfleet.com/docs/examples#camoufox-profile)
-   [Firefox that stays logged in between sessions](https://cdpfleet.com/docs/examples#firefox-profile)
-   [WebKit that stays logged in between sessions](https://cdpfleet.com/docs/examples#webkit-profile)

1 more in [cases](https://cdpfleet.com/docs/cases) and [recipes](https://cdpfleet.com/docs/examples).

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

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