Open in the explorer

Allow Copilot browser use on specified URLs

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 158, Windows 7 or later
ADMX file
msedge.admx
Internal name
msedge/CopilotBrowserUseAllowList

Explanation

Defines the URLs where Copilot browser use is allowed. Users can't modify this policy.

If you don't configure this policy, all URLs are allowed unless they match an entry in the 'CopilotBrowserUseBlockList' (Block Copilot browser use on specified URLs) policy.

If you configure this policy with a non-empty list, a URL must match an allow rule that takes precedence over any matching block rule. A configured but empty list allows no URLs. To allow all URLs, include '*'. A more specific block list rule still blocks access when the allow list contains '*'.

URL patterns use the same syntax as the 'URLAllowlist' (Define a list of allowed URLs) and 'URLBlocklist' (Block access to a list of URLs) policies. Patterns can specify schemes, hosts, ports, paths, and query conditions. A hostname such as contoso.com also matches its subdomains. Start the hostname with a dot, such as .contoso.com, to match only that host. Don't use '[*.]contoso.com' or '*.contoso.com'; these forms don't match URLs.

Paths match by prefix, not by path segment. For example, contoso.com/team matches both /team/report and /teamwork.

The most specific matching rule determines whether a URL is allowed or blocked. Exact-host rules take precedence over rules that include subdomains, followed by longer hostnames, longer paths, and more query conditions. If allow and block rules are equally specific, the allow rule wins. Schemes and ports restrict matching but don't increase a rule's precedence.

Only the first 1,500 entries in each list are used; later entries are ignored.

This policy doesn't enable Copilot browser use. The private-network and intranet check also reads this allow list using content-settings patterns, which differ from the URL syntax above. Entries that win under that grammar exempt destinations from that check; '*' can exempt private IP addresses, localhost and intranet hosts. '[*.]contoso.com' can grant that exemption but doesn't match the browser-use URL list, while contoso.com includes subdomains for the URL list but exempts only the exact host from the private-network check. Other safety checks still apply. For guidance on formatting URL patterns, see https://go.microsoft.com/fwlink/?linkid=2095322.

Example value:

https://www.contoso.com/approved
contoso.edu
contoso.net
.login.contoso.us

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/CopilotBrowserUseAllowList
$k = 'HKLM:\Software\Policies\Microsoft\Edge\CopilotBrowserUseAllowList'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Allow Copilot browser use on specified URLs
# Non-additive list: existing values of the key are cleared first
if (Test-Path -Path $k) { (Get-Item -Path $k).Property | ForEach-Object { Remove-ItemProperty -Path $k -Name ([WildcardPattern]::Escape($_)) -ErrorAction SilentlyContinue } }
$values = @('<value1>', '<value2>')  # Replace the values with your own
$i = 1
foreach ($v in $values) { Set-ItemProperty -Path $k -Name ('' + $i) -Value $v -Type String; $i++ }

Disable

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

Revert to "Not configured"

# Revert to "Not configured": msedge/CopilotBrowserUseAllowList
$k = 'HKLM:\Software\Policies\Microsoft\Edge\CopilotBrowserUseAllowList'
Remove-Item -Path $k -Recurse -Force -ErrorAction SilentlyContinue

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Allow Copilot browser use on specified URLsCopilotBrowserUseAllowListDescList (table)listSoftware\Policies\Microsoft\Edge\CopilotBrowserUseAllowListValues named “” + numberREG_SZ (values under the key)

Application

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

Official templates downloaded on November 12, 2026.