Open in the explorer

Control Manifest v2 extension availability

Type
Computer and user
GPO path
Computer Configuration › Policies › Administrative Templates › Microsoft Edge › Extensions User Configuration › Policies › Administrative Templates › Microsoft Edge › Extensions
Supported on
Microsoft Edge version 123, Windows 7 or later
ADMX file
msedge.admx
Internal name
msedge/ExtensionManifestV2Availability

Explanation

Control if Manifest v2 extensions can be used by browser.

Manifest v2 extensions support will be deprecated and all extensions need to be migrated to v3 in the future. More information about and the timeline of the migration hasn't been established.

If the policy is set to Default or not set, v2 extension loading is decided by browser. This follows the preceding timeline when it's established.

If the policy is set to Disable, v2 extensions installation are blocked, and existing ones are disabled. This option is going to be treated the same as if the policy is unset after v2 support is turned off by default.

If the policy is set to Enable, v2 extensions are allowed. The option is going to be treated the same as if the policy isn't set before v2 support is turned off by default.

If the policy is set to EnableForForcedExtensions, force installed v2 extensions are allowed. This includes extensions that are listed by 'ExtensionInstallForcelist' (Control which extensions are installed silently) or 'ExtensionSettings' (Configure extension management settings) with installation_mode "force_installed" or "normal_installed". All other v2 extensions are disabled. The option is always available regardless of the manifest migration state.

Extensions availabilities are still controlled by other policies.

Policy options mapping:

* Default (0) = Default browser behavior

* Disable (1) = Manifest v2 is disabled

* Enable (2) = Manifest v2 is enabled

* EnableForForcedExtensions (3) = Manifest v2 is enabled for forced extensions only

Use the preceding information when configuring this policy.

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/ExtensionManifestV2Availability
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
# Control Manifest v2 extension availability
# Possible options:
#   Default browser behavior = 0
#   Manifest v2 is disabled = 1
#   Manifest v2 is enabled = 2
#   Manifest v2 is enabled for forced extensions only = 3
Set-ItemProperty -Path $k -Name 'ExtensionManifestV2Availability' -Value 0 -Type DWord

Disable

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

Revert to "Not configured"

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

User (HKCU)

Enable

Disable

Revert to "Not configured"

Options (1)

LabelControlRegistry valueREG typeConstraints / details
Control Manifest v2 extension availabilityExtensionManifestV2AvailabilityDrop-down listenumExtensionManifestV2AvailabilityREG_DWORD
LabelValue
Default browser behaviorREG_DWORD = 0
Manifest v2 is disabledREG_DWORD = 1
Manifest v2 is enabledREG_DWORD = 2
Manifest v2 is enabled for forced extensions onlyREG_DWORD = 3

Application

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

Official templates downloaded on November 12, 2026.