Office Admin Explorer

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

Classic Outlook only. The new Outlook for Windows ignores most of these Office policies – it is configured through Exchange Online (OWA mailbox policy) instead.

Registry value
disablecomtowebupgrade
Group PolicyDisable web add-in installation on migration to new Outlook for Windows
German versionDeaktivieren der Web-Add-In-Installation bei der Migration zum neuen Outlook für Windows
Intune settings catalogDisable web add-in installation on migration to new Outlook for Windows (User)
ScopeUser · HKCU
ADMXoutlk16.admx · L_DisableComToWebAddinUpgrade
Open in the interactive explorer+ Add to my collection

Group Policy path

User Configuration\Policies\Administrative Templates\Microsoft Outlook 2016\Miscellaneous
Benutzerkonfiguration\Richtlinien\Administrative Vorlagen\Microsoft Outlook 2016\Verschiedenes

Registry

ValueData
HKCU\Software\policies\microsoft\office\16.0\outlook\addins
disablecomtowebupgradeEnabled = 1 · Disabled = 0

Not configured = the value does not exist – the application default applies and users may change the setting.

PowerShell

Check the current value (read-only)

# --- Settings ---
$root = 'HKCU:'   # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'

$key = "$root\Software\policies\microsoft\office\16.0\outlook\addins"
foreach ($name in @('disablecomtowebupgrade')) {
    try   { '{0} = {1}' -f $name, (Get-ItemPropertyValue -Path $key -Name $name -ErrorAction Stop) }
    catch { '{0}: not configured' -f $name }
}

Admin rights needed: HKCU\Software\Policies is read-only for standard users. An elevated session writes to the admin's own HKCU – to set it for another signed-in user, change $root to Registry::HKEY_USERS\<SID>.

Enable

# --- Settings ---
$root = 'HKCU:'   # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'

try {
    $key = "$root\Software\policies\microsoft\office\16.0\outlook\addins"
    if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
    New-ItemProperty -Path $key -Name 'disablecomtowebupgrade' -PropertyType DWord -Value 1 -Force -ErrorAction Stop | Out-Null   # Enabled
    'Done.'
}
catch { Write-Error "Failed: $($_.Exception.Message)" }
Disable
# --- Settings ---
$root = 'HKCU:'   # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'

try {
    $key = "$root\Software\policies\microsoft\office\16.0\outlook\addins"
    if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
    New-ItemProperty -Path $key -Name 'disablecomtowebupgrade' -PropertyType DWord -Value 0 -Force -ErrorAction Stop | Out-Null   # Disabled
    'Done.'
}
catch { Write-Error "Failed: $($_.Exception.Message)" }
Reset to Not configured
# --- Settings ---
$root = 'HKCU:'   # other signed-in user (elevated): 'Registry::HKEY_USERS\<SID>'

$key = "$root\Software\policies\microsoft\office\16.0\outlook\addins"
Remove-ItemProperty -Path $key -Name 'disablecomtowebupgrade' -ErrorAction SilentlyContinue
'Policy values removed (Not configured).'

Intune (settings catalog)

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

Settings catalog → Add settings → search for the name above.

Intune Settings Catalog Viewer ↗

Alternative: custom profile (OMA-URI)
OMA-URI
./User/Vendor/MSFT/Policy/Config/outlk16v14~Policy~L_MicrosoftOfficeOutlook~L_Miscellaneous/L_DisableComToWebAddinUpgrade
Data typeString
Value<enabled/> · <disabled/>

Cloud Policy

Cloud Policy (config.office.com → Customization → Policy Management) offers many user policies of the Microsoft 365 Apps – search for Disable web add-in installation on migration to new Outlook for Windows. It also applies to unmanaged devices and wins over GPO and Intune for the same setting.

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

Same category: Microsoft Outlook 2016 › Miscellaneous

All policies in this category · All 406 policies of outlk16.admx