Microsoft Edge
Block 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 blocked. Users can't modify this policy. A matching block rule blocks access unless a more specific or equally specific allow rule takes precedence. Blocking can still apply when the 'CopilotBrowserUseAllowList' (Allow Copilot browser use on specified URLs) policy isn't configured or contains '*'. For example, you can allow all URLs with '*' and block paths starting with /private on contoso.com and its subdomains with this policy. If you don't configure this policy or configure an empty list, this policy blocks no URLs. The allow list still applies: an unconfigured allow list allows all URLs, a configured empty allow list allows none, and a populated allow list allows only listed URLs. 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/private matches both /private/report and /private-old. 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. 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/private 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 |
|---|---|---|---|
| Block Copilot browser use on specified URLs | List of values (list) | Software\Policies\Microsoft\Edge\CopilotBrowserUseBlockList |
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\CopilotBrowserUseBlockList]
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: Block Copilot browser use on specified URLs
# Name: CopilotBrowserUseBlockList
# Scope: Machine
# State: Enabled
# Source: msedge.admx
Clear-RegistryKeyValues -Path 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\CopilotBrowserUseBlockList'
- 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: CopilotBrowserUseBlockListDesc
ADMX profile candidate (OMA-URI)
./Device/Vendor/MSFT/Policy/Config/ADMX_msedge/CopilotBrowserUseBlockListIntune 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: Block Copilot browser use on specified URLs
# Name: CopilotBrowserUseBlockList
# Scope: Machine
# State: Enabled
# Source: msedge.admx
$keyPath = 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\CopilotBrowserUseBlockList'
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\CopilotBrowserUseBlockList') | 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: Block Copilot browser use on specified URLs
# Name: CopilotBrowserUseBlockList
# Scope: Machine
# State: Enabled
# Source: msedge.admx
Clear-RegistryKeyValues -Path 'Registry::HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge\CopilotBrowserUseBlockList'
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
CopilotBrowserUseBlockList- 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.CopilotBrowserUseBlockList)" explainText="$(string.CopilotBrowserUseBlockList_Explain)" key="Software\Policies\Microsoft\Edge" name="CopilotBrowserUseBlockList" presentation="$(presentation.CopilotBrowserUseBlockList)" 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="CopilotBrowserUseBlockListDesc" key="Software\Policies\Microsoft\Edge\CopilotBrowserUseBlockList" valuePrefix="" />
</elements>
</policy>Editor controls
<presentation id="CopilotBrowserUseBlockList" xmlns="http://schemas.microsoft.com/GroupPolicy/2006/07/PolicyDefinitions"><listBox refId="CopilotBrowserUseBlockListDesc">Block 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>