Open in the explorer

Control the mode of DNS-over-HTTPS

Type
Computer and user
GPO path
Computer Configuration › Policies › Administrative Templates › Microsoft Edge User Configuration › Policies › Administrative Templates › Microsoft Edge
Supported on
Microsoft Edge version 83, Windows 7 or later
ADMX file
msedge.admx
Internal name
msedge/DnsOverHttpsMode

Explanation

Control the mode of the DNS-over-HTTPS resolver. This policy only sets the default mode for each query.
The mode can be overridden for special types of queries such as requests to resolve a DNS-over-HTTPS server hostname.

The "off" mode disables DNS-over-HTTPS.

The "automatic" mode sends DNS-over-HTTPS queries first if a DNS-over-HTTPS server is available, and falls back to sending insecure queries on error.

The "secure" mode only sends DNS-over-HTTPS queries and will fail to resolve on error.

If you don't configure this policy for managed devices, DNS-over-HTTPS queries aren't sent. Instead, the browser
may send DNS requests to a resolver associated with the user's system resolver.
This could lead to a less secure or private DNS resolution process, depending on the resolver in use.

Policy options mapping:

* off (off) = Disable DNS-over-HTTPS

* automatic (automatic) = Enable DNS-over-HTTPS with insecure fallback

* secure (secure) = Enable DNS-over-HTTPS without insecure fallback

Use the preceding information when configuring this policy.

Example value: off

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge
HKEY_CURRENT_USER\Software\Policies\Microsoft\Edge
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: msedge/DnsOverHttpsMode
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Control the mode of DNS-over-HTTPS
# Possible options:
#   Disable DNS-over-HTTPS = off
#   Enable DNS-over-HTTPS with insecure fallback = automatic
#   Enable DNS-over-HTTPS without insecure fallback = secure
Set-ItemProperty -Path $k -Name 'DnsOverHttpsMode' -Value 'off' -Type String

Disable

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

Revert to "Not configured"

# Revert to "Not configured": msedge/DnsOverHttpsMode
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
Remove-ItemProperty -Path $k -Name 'DnsOverHttpsMode' -ErrorAction SilentlyContinue

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Control the mode of DNS-over-HTTPSDnsOverHttpsModeDrop-down listenumDnsOverHttpsModeREG_SZ
LabelValue
Disable DNS-over-HTTPSREG_SZ = off
Enable DNS-over-HTTPS with insecure fallbackREG_SZ = automatic
Enable DNS-over-HTTPS without insecure fallbackREG_SZ = secure

Application

Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates

Official templates downloaded on November 12, 2026.