Microsoft Edge
Allow Copilot browser use on specified URLs
Supported on Microsoft Edge version 158, Windows 7 or later
What it does
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
What it writes
- Hive
- HKEY_LOCAL_MACHINE or HKEY_CURRENT_USER
- Registry key
Software\Policies\Microsoft\Edge
Options
| Option | Type | Registry value | Allowed values |
|---|---|---|---|
| Allow Copilot browser use on specified URLs | List of values (list) | Software\Policies\Microsoft\Edge\CopilotBrowserUseAllowList |
Any |
Configure and deploy
Choose a state and the option values; the output below is generated from the template for exactly that.
Enabled · Computer · template defaults
Registry file (.reg)
Windows Registry Editor Version 5.00
[-HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\CopilotBrowserUseAllowList]
PowerShell
$ErrorActionPreference = 'Stop'
function Set-RegistryValue {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name,
[Parameter(Mandatory = $true)][string] $PropertyType,
[Parameter(Mandatory = $true)][object] $Value
)
if (-not (Test-Path -LiteralPath $Path)) {
New-Item -Path $Path -Force | Out-Null
}
New-ItemProperty -LiteralPath $Path -Name $Name -PropertyType $PropertyType -Value $Value -Force | Out-Null
}
function Remove-RegistryValue {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name
)
if (Test-Path -LiteralPath $Path) {
Remove-ItemProperty -LiteralPath $Path -Name $Name -Force -ErrorAction SilentlyContinue
}
}
function Clear-RegistryKeyValues {
param(
[Parameter(Mandatory = $true)][string] $Path
)
if (-not (Test-Path -LiteralPath $Path)) {
return
}
foreach ($propertyName in (Get-Item -LiteralPath $Path).Property) {
Remove-ItemProperty -LiteralPath $Path -Name $propertyName -Force -ErrorAction SilentlyContinue
}
}
# Policy: Allow Copilot browser use on specified URLs
# Name: CopilotBrowserUseAllowList
# Scope: Machine
# State: Enabled
# Source: msedge.admx
Clear-RegistryKeyValues -Path 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\CopilotBrowserUseAllowList'
- The OMA-URI is an inferred ADMX-backed Policy CSP candidate derived from the source ADMX file name and policy name.
- Some Microsoft policies use built-in Policy CSP pages whose area names don't match the ADMX file name, so verify the candidate against Microsoft Learn before deployment.
- The generated payload is incomplete because one or more ADMX element values were not supplied: CopilotBrowserUseAllowListDesc
ADMX profile candidate (OMA-URI)
./Device/Vendor/MSFT/Policy/Config/ADMX_msedge/CopilotBrowserUseAllowListIntune remediation scripts
Detection
$ErrorActionPreference = 'Stop'
$reasons = [System.Collections.Generic.List[string]]::new()
function Test-RegistryValueExists {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name
)
if (-not (Test-Path -LiteralPath $Path)) {
return $false
}
return $null -ne (Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction SilentlyContinue)
}
function Test-RegistryValueEquals {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name,
[Parameter(Mandatory = $true)][string] $Kind,
[Parameter(Mandatory = $true)][object] $Expected
)
if (-not (Test-Path -LiteralPath $Path)) {
return $false
}
$valueObject = Get-ItemProperty -LiteralPath $Path -Name $Name -ErrorAction SilentlyContinue
if ($null -eq $valueObject) {
return $false
}
$actual = $valueObject.$Name
switch ($Kind) {
'String' { return [string]$actual -ceq [string]$Expected }
'ExpandString' { return [string]$actual -ceq [string]$Expected }
'DWord' { return [uint32]$actual -eq [uint32]$Expected }
'QWord' {
$actualBits = if ($actual -is [uint64]) { $actual } else { [BitConverter]::ToUInt64([BitConverter]::GetBytes([int64]$actual), 0) }
$expectedBits = if ($Expected -is [uint64]) { $Expected } else { [BitConverter]::ToUInt64([BitConverter]::GetBytes([int64]$Expected), 0) }
return $actualBits -eq $expectedBits
}
'MultiString' {
$actualArray = @($actual)
$expectedArray = @($Expected)
if ($actualArray.Count -ne $expectedArray.Count) { return $false }
for ($index = 0; $index -lt $actualArray.Count; $index++) {
if ([string]$actualArray[$index] -cne [string]$expectedArray[$index]) { return $false }
}
return $true
}
'Binary' {
$actualArray = [byte[]]$actual
$expectedArray = [byte[]]$Expected
if ($actualArray.Length -ne $expectedArray.Length) { return $false }
for ($index = 0; $index -lt $actualArray.Length; $index++) {
if ($actualArray[$index] -ne $expectedArray[$index]) { return $false }
}
return $true
}
default { return [string]$actual -ceq [string]$Expected }
}
}
# Policy: Allow Copilot browser use on specified URLs
# Name: CopilotBrowserUseAllowList
# Scope: Machine
# State: Enabled
# Source: msedge.admx
$keyPath = 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\CopilotBrowserUseAllowList'
if (Test-Path -LiteralPath $keyPath) {
$propertyNames = (Get-Item -LiteralPath $keyPath).Property
if ($propertyNames.Count -gt 0) {
$reasons.Add('Key should be empty: HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\CopilotBrowserUseAllowList') | Out-Null
}
}
if ($reasons.Count -eq 0) {
Write-Output 'Compliant'
exit 0
}
$reasons | ForEach-Object { Write-Output $_ }
exit 1
Remediation
$ErrorActionPreference = 'Stop'
function Set-RegistryValue {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name,
[Parameter(Mandatory = $true)][string] $PropertyType,
[Parameter(Mandatory = $true)][object] $Value
)
if (-not (Test-Path -LiteralPath $Path)) {
New-Item -Path $Path -Force | Out-Null
}
New-ItemProperty -LiteralPath $Path -Name $Name -PropertyType $PropertyType -Value $Value -Force | Out-Null
}
function Remove-RegistryValue {
param(
[Parameter(Mandatory = $true)][string] $Path,
[Parameter(Mandatory = $true)][string] $Name
)
if (Test-Path -LiteralPath $Path) {
Remove-ItemProperty -LiteralPath $Path -Name $Name -Force -ErrorAction SilentlyContinue
}
}
function Clear-RegistryKeyValues {
param(
[Parameter(Mandatory = $true)][string] $Path
)
if (-not (Test-Path -LiteralPath $Path)) {
return
}
foreach ($propertyName in (Get-Item -LiteralPath $Path).Property) {
Remove-ItemProperty -LiteralPath $Path -Name $propertyName -Force -ErrorAction SilentlyContinue
}
}
# Policy: Allow Copilot browser use on specified URLs
# Name: CopilotBrowserUseAllowList
# Scope: Machine
# State: Enabled
# Source: msedge.admx
Clear-RegistryKeyValues -Path 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\CopilotBrowserUseAllowList'
History 50 retained releases
- 158.0.4370.3319 Nov 2026Registry key:
Software\Policies\Microsoft\Edge· Value name:Not specified- Added in this release.
Template
- Internal name
CopilotBrowserUseAllowList- Namespace
Microsoft.Policies.Edge- Template file
msedge.admx- Release
- Microsoft Edge 158.0.4370.33 · file set
4cf10816a35c8996…
Definition, editor controls and support
Definition
<policy class="Both" displayName="$(string.CopilotBrowserUseAllowList)" explainText="$(string.CopilotBrowserUseAllowList_Explain)" key="Software\Policies\Microsoft\Edge" name="CopilotBrowserUseAllowList" presentation="$(presentation.CopilotBrowserUseAllowList)" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions">
<parentCategory ref="Microsoft.Policies.Edge:microsoft_edge" />
<supportedOn ref="Microsoft.Policies.Edge:SUPPORTED_WIN7_V158" />
<elements>
<list id="CopilotBrowserUseAllowListDesc" key="Software\Policies\Microsoft\Edge\CopilotBrowserUseAllowList" valuePrefix="" />
</elements>
</policy>Editor controls
<presentation id="CopilotBrowserUseAllowList" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions"><listBox refId="CopilotBrowserUseAllowListDesc">Allow Copilot browser use on specified URLs</listBox></presentation>Supported platforms and category
Microsoft.Policies.Edge:category:microsoft_edge
<category displayName="$(string.microsoft_edge)" name="microsoft_edge" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
Microsoft.Policies.Edge:definition:SUPPORTED_WIN7_V158
<definition displayName="$(string.SUPPORTED_WIN7_V158)" name="SUPPORTED_WIN7_V158" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
Microsoft.Policies.Edge:category:microsoft_edge
<category displayName="$(string.microsoft_edge)" name="microsoft_edge" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
<strings><string id="Microsoft.Policies.Edge:microsoft_edge">Microsoft Edge</string></strings>
Microsoft.Policies.Edge:definition:SUPPORTED_WIN7_V158
<definition displayName="$(string.SUPPORTED_WIN7_V158)" name="SUPPORTED_WIN7_V158" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions" />
<strings><string id="Microsoft.Policies.Edge:SUPPORTED_WIN7_V158">Microsoft Edge version 158, Windows 7 or later</string></strings>