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 Policy | Disable web add-in installation on migration to new Outlook for Windows |
| German version | Deaktivieren der Web-Add-In-Installation bei der Migration zum neuen Outlook für Windows |
| Intune settings catalog | Disable web add-in installation on migration to new Outlook for Windows (User) |
| Scope | User · HKCU |
| ADMX | outlk16.admx · L_DisableComToWebAddinUpgrade |
Group Policy path
Registry
| Value | Data |
|---|---|
HKCU\Software\policies\microsoft\office\16.0\outlook\addins | |
| disablecomtowebupgrade | Enabled = 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 type | String |
| 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
- Specify delay before sending people search requestpresencecontactfastsearchdelay
- Set the time-out interval for Outlook people searchpresencecontactfastsearchtimeout
- Do not expand Contact Groupsdisabledlexpansion
- Extend Outlook Autosave to include encrypted e-mail messagesallowautosavecryptomail
- Managing Categories during e-mail exchangesmsoridolacceptcategories
- Add new categoriesnewcategories
- Prevent MAPI services from being addeddisablecreateservices
- Do not display "Open this task" button for workflow tasksdisabletaskedit
- Disable VLV Browsing on LDAP serversdisablevlvbrowsing
- Do not download rights permission license information for IRM e-mail during Exchange folder syncdonotacquiredrmlicenseonsync
- Prevent users from adding e-mail account typesdisableexchange
- Prevent users from making changes to Outlook profilesmodifyaccounts
All policies in this category · All 406 policies of outlk16.admx