[Launch options](https://cdpfleet.com/docs/options) # `headless` Run without a display. **Use it for:** Bulk scraping and tests where nobody watches: lower memory and faster launches. Leave it headful (the default) when a site checks for headless tells, or when you want a recording or live view without extra options. **Browsers:** [Google Chrome](https://cdpfleet.com/docs/browsers/chrome#opt-headless), [Microsoft Edge](https://cdpfleet.com/docs/browsers/edge#opt-headless), [Brave](https://cdpfleet.com/docs/browsers/brave#opt-headless), [Opera](https://cdpfleet.com/docs/browsers/opera#opt-headless), [Naver Whale](https://cdpfleet.com/docs/browsers/whale#opt-headless), [Yandex Browser](https://cdpfleet.com/docs/browsers/yandex#opt-headless), [Chromium](https://cdpfleet.com/docs/browsers/chromium#opt-headless), [Patchright](https://cdpfleet.com/docs/browsers/patchright#opt-headless), [Rebrowser](https://cdpfleet.com/docs/browsers/rebrowser#opt-headless), [Camoufox](https://cdpfleet.com/docs/browsers/camoufox#opt-headless), [Firefox](https://cdpfleet.com/docs/browsers/firefox#opt-headless), [WebKit](https://cdpfleet.com/docs/browsers/webkit#opt-headless). ## Details ### Google Chrome, Microsoft Edge, Brave, Opera, Naver Whale, Yandex Browser, Chromium, Patchright, Rebrowser - **Type:** `boolean | "new" | "shell"` - **Default:** false (headful, on a virtual display) - **Example:** `{"headless":"new"}` `true` or `"new"` runs Chrome's new headless mode; `"shell"` runs the lightweight headless shell. Anything else — including `1` and `"false"` — runs headful on a virtual display, which is harder to detect and is billed as 2 threads (headless is 1). ### Firefox, WebKit - **Type:** `boolean` - **Default:** false (headful, on a virtual display) - **Example:** `{"headless":true}` Any truthy value runs headless — including the strings `"false"` and `"0"`, so send a real boolean. `false`, `0` or omitting it runs headful on a virtual display (billed as 2 threads; headless is 1). ### Camoufox - **Type:** `boolean | "virtual"` - **Default:** false (headful, on a virtual display) - **Example:** `{"headless":false}` Any truthy value runs headless — including the strings `"false"` and `"0"`, so send a real boolean. `false`, `"virtual"` or omitting it runs headful on a virtual display, which Camoufox recommends for stealth (billed as 2 threads; headless is 1). ## Used in - [Case 84: Does the TLS fingerprint (JA4) explain which browsers got in? Twelve browsers against six vendors](https://cdpfleet.com/docs/cases/ja4-vs-vendor-verdicts) - [Case 83: Brave's fingerprint randomisation per site, per context and per launch, and what public fingerprint pages make of it](https://cdpfleet.com/docs/cases/brave-farbling) - [Case 81: Behaviour scoring: Camoufox humanize on and off vs plain Chrome clicks on a public bot-test form](https://cdpfleet.com/docs/cases/behaviour-scoring-humanize) - [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 78: keep\_alive: an agent run that survives its client going away](https://cdpfleet.com/docs/cases/keep-alive-reconnect) - [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 68: CAPTCHA demo pages: what reCAPTCHA v3 scores and hCaptcha show seven browsers, and why a demo can't rank them](https://cdpfleet.com/docs/cases/captcha-scores-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 63: What four public bot-test pages say about five fleet browsers](https://cdpfleet.com/docs/cases/what-fingerprint-test-pages-see) 66 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/headless · Markdown: https://cdpfleet.com/docs/options/headless.md · All docs for AI tools: https://cdpfleet.com/llms.txt