Open in the explorer

Control use of the Headless Mode

Type
Computer and user
GPO path
Computer Configuration › Policies › Administrative Templates › Google › Google Chrome User Configuration › Policies › Administrative Templates › Google › Google Chrome
Supported on
Microsoft Windows 7 or later
ADMX file
chrome.admx
Internal name
chrome/HeadlessMode

Explanation

Setting this policy to Enabled or leaving the policy unset allows use of the headless mode. Setting this policy to Disabled denies use of the headless mode.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Google\Chrome
HKEY_CURRENT_USER\Software\Policies\Google\Chrome
Value name
not defined in the ADMX

Enable / disable values: not defined in the ADMX (see the options below).

PowerShell

PowerShell commands that write to the registry what the policy would write. Values in angle brackets (<…>) must be replaced.

Writing directly to the registry bypasses Group Policy: if a GPO manages this value, it will be rewritten at the next gpupdate; otherwise the value stays in place (the "tattooing" effect). Prefer a GPO or, locally, LGPO.exe. Run PowerShell as administrator for HKLM. Some policies need a restart or gpupdate /force.

Computer (HKLM)

Enable

# Enable: chrome/HeadlessMode
$k = 'HKLM:\Software\Policies\Google\Chrome'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Control use of the Headless Mode
# Possible options:
#   Allow use of the Headless Mode = 1
#   Do not allow use of the Headless Mode = 2
Set-ItemProperty -Path $k -Name 'HeadlessMode' -Value 1 -Type DWord

Disable

# Disable: chrome/HeadlessMode
# No value is written in the "Disabled" state (nothing defined in the ADMX)

Revert to "Not configured"

# Revert to "Not configured": chrome/HeadlessMode
$k = 'HKLM:\Software\Policies\Google\Chrome'
Remove-ItemProperty -Path $k -Name 'HeadlessMode' -ErrorAction SilentlyContinue

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Control use of the Headless ModeHeadlessModeDrop-down listenumHeadlessModeREG_DWORD
LabelValue
Allow use of the Headless ModeREG_DWORD = 1
Do not allow use of the Headless ModeREG_DWORD = 2

Application

Google Chrome (Google) — November 2026 templates

Official templates downloaded on November 12, 2026.