Manage user setting for new Outlook automatic migration
Explanation
This policy allows you to manage the user setting for enabling or disabling automatic migration to the new Outlook app, initiated by Microsoft.
If you don't configure this policy (default), the user setting for automatic migration is not controlled by the policy, allowing the user to manage it themselves. This user setting for automatic migration is enabled by default.
If you enable this policy, the user setting controlling automatic migration is enabled. Automatic migration to the new Outlook app is allowed, and the user cannot change this setting.
If you disable this policy, the user setting controlling automatic migration is disabled. Automatic migration to the new Outlook app is not allowed, and the user cannot change this setting.
Note that this user setting is not available for migration initiated via the 'Admin-Controlled Migration to New Outlook' policy.
Registry
HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\outlook\preferences- Value name
newoutlookmigrationusersetting
| 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_NewOutlookMigrationUserSetting
$k = 'HKCU:\software\policies\microsoft\office\16.0\outlook\preferences'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'newoutlookmigrationusersetting' -Value 1 -Type DWordDisable
# Disable: outlk16/L_NewOutlookMigrationUserSetting
$k = 'HKCU:\software\policies\microsoft\office\16.0\outlook\preferences'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'newoutlookmigrationusersetting' -Value 0 -Type DWordRevert to "Not configured"
# Revert to "Not configured": outlk16/L_NewOutlookMigrationUserSetting
$k = 'HKCU:\software\policies\microsoft\office\16.0\outlook\preferences'
Remove-ItemProperty -Path $k -Name 'newoutlookmigrationusersetting' -ErrorAction SilentlyContinueApplication
Microsoft 365 Apps / Office (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.