Open in the explorer

Manage user setting for new Outlook automatic migration

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

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

Disable

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

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

Application

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

Official templates downloaded on November 12, 2026.