Disable web add-in installation on migration to new Outlook for Windows
Explanation
This policy setting allows you to disable installation of web add-in equivalents of COM add-ins on the switch to new Outlook. The add-ins available for migration are listed in https://aka.ms/newoutlooksettings.
Learn more about Outlook web add-ins at https://learn.microsoft.com/office/dev/add-ins/outlook/outlook-add-ins-overview.
COM add-ins do not work in new Outlook for Windows. By default, users in the organization will get the option to install available web add-ins, in place of COM add-ins, when they move from classic Outlook for Windows.
If you enable this policy setting, users will not get the option to install web add-ins in place of their COM add-ins.
If you disable or do not configure this policy setting, users will get an option to install web add-ins in place of their COM add-ins.
Registry
HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\outlook\addins- Value name
disablecomtowebupgrade
| 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.
Enable
# Enable: outlk16/L_DisableComToWebAddinUpgrade
$k = 'HKCU:\software\policies\microsoft\office\16.0\outlook\addins'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'disablecomtowebupgrade' -Value 1 -Type DWordDisable
# Disable: outlk16/L_DisableComToWebAddinUpgrade
$k = 'HKCU:\software\policies\microsoft\office\16.0\outlook\addins'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'disablecomtowebupgrade' -Value 0 -Type DWordRevert to "Not configured"
# Revert to "Not configured": outlk16/L_DisableComToWebAddinUpgrade
$k = 'HKCU:\software\policies\microsoft\office\16.0\outlook\addins'
Remove-ItemProperty -Path $k -Name 'disablecomtowebupgrade' -ErrorAction SilentlyContinueApplication
Microsoft 365 Apps / Office (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.