Allow software WebGL fallback using SwiftShader
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\EdgeHKEY_CURRENT_USER\Software\Policies\Microsoft\Edge- Value name
EnableUnsafeSwiftShader
| State | Value written |
|---|---|
| Enabled | REG_DWORD = 1 |
| Disabled | REG_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 DWordDisable
# 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 DWordRevert to "Not configured"
# Revert to "Not configured": msedge/EnableUnsafeSwiftShader
$k = 'HKLM:\Software\Policies\Microsoft\Edge'
Remove-ItemProperty -Path $k -Name 'EnableUnsafeSwiftShader' -ErrorAction SilentlyContinueUser (HKCU)
Enable
Disable
Revert to "Not configured"
Application
Microsoft Edge (+ Edge Update, WebView2) (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.