Specify URI template of desired DNS-over-HTTPS resolver
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\EdgeHKEY_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 StringDisable
# 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 SilentlyContinueUser (HKCU)
Enable
Disable
Revert to "Not configured"
Options (1)
| Label | Control | Registry value | REG type | Constraints / details |
|---|---|---|---|---|
| Specify URI template of desired DNS-over-HTTPS resolverDnsOverHttpsTemplates | Text boxtext | DnsOverHttpsTemplates | REG_SZ | Max length: 1000000 |
Application
Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.