Open in the explorer

Specify URI template of desired DNS-over-HTTPS resolver

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/DnsOverHttpsTemplates

Explanation

The URI template of the desired DNS-over-HTTPS resolver. To specify multiple DNS-over-HTTPS resolvers, separate the corresponding URI templates with spaces.

If you set 'DnsOverHttpsMode' (Control the mode of DNS-over-HTTPS) to "secure", then this policy must be set and can't be empty.

If you set 'DnsOverHttpsMode' to "automatic" and this policy is set, then the URI templates specified are used. If you don't set this policy, then hardcoded mappings are used to attempt to upgrade the user's current DNS resolver to a DoH resolver operated by the same provider.

If the URI template contains a dns variable, requests to the resolver use GET; otherwise, requests use POST.

Incorrectly formatted templates will be ignored.

Example value: https://dns.example.net/dns-query{?dns}

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/DnsOverHttpsTemplates
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Specify URI template of desired DNS-over-HTTPS resolver
Set-ItemProperty -Path $k -Name 'DnsOverHttpsTemplates' -Value '<value>' -Type String

Disable

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

Revert to "Not configured"

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

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Specify URI template of desired DNS-over-HTTPS resolverDnsOverHttpsTemplatesText boxtextDnsOverHttpsTemplatesREG_SZ
Max length: 1000000

Application

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

Official templates downloaded on November 12, 2026.