Open in the explorer

Allow software WebGL fallback using SwiftShader

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

Explanation

Controls whether SwiftShader is used as a fallback for WebGL when hardware GPU acceleration isn't available.

When enabled, Microsoft Edge uses SwiftShader to support WebGL on systems without GPU acceleration, such as headless environments or virtual machines.

Starting in Microsoft Edge version 144, SwiftShader is deprecated due to security concerns. As a result, WebGL context creation fails in scenarios where SwiftShader is used. Enabling this policy allows organizations to temporarily defer the deprecation and continue using SwiftShader.

If you disable or don't configure this policy, WebGL context creation can fail on systems without hardware acceleration. This could cause web content relying on WebGL to function incorrectly if it doesn't handle context creation failures.

Note: This policy is temporary and scheduled for removal in a future release. Microsoft doesn't guarantee the security of environments where this policy is enabled.

Registry

HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Edge
HKEY_CURRENT_USER\Software\Policies\Microsoft\Edge
Value name
EnableUnsafeSwiftShader
StateValue written
EnabledREG_DWORD = 1
DisabledREG_DWORD = 0

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/EnableUnsafeSwiftShader
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'EnableUnsafeSwiftShader' -Value 1 -Type DWord

Disable

# Disable: msedge/EnableUnsafeSwiftShader
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'EnableUnsafeSwiftShader' -Value 0 -Type DWord

Revert to "Not configured"

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

User (HKCU)

Enable

Disable

Revert to "Not configured"

Application

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

Official templates downloaded on November 12, 2026.