Open in the explorer

Disable web add-in installation on migration to new Outlook for Windows

Type
User
GPO path
User Configuration › Policies › Administrative Templates › Microsoft Outlook 2016 › Miscellaneous
Supported on
At least Windows Server 2008 R2 or Windows 7
ADMX file
outlk16.admx
Internal name
outlk16/L_DisableComToWebAddinUpgrade

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
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.

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 DWord

Disable

# 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 DWord

Revert 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 SilentlyContinue

Application

Microsoft 365 Apps / Office (Microsoft) — November 2026 templates

Official templates downloaded on November 12, 2026.