Manage user setting for new Outlook automatic migration
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 | newoutlookmigrationusersetting |
| Group Policy | Manage user setting for new Outlook automatic migration |
| German version | Manage user setting for new Outlook automatic migration |
| Scope | User · HKCU |
| ADMX | outlk16.admx · L_NewOutlookMigrationUserSetting |
Group Policy path
Registry
| Value | Data |
|---|---|
HKCU\Software\policies\microsoft\office\16.0\outlook\preferences | |
| newoutlookmigrationusersetting | 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\preferences"
foreach ($name in @('newoutlookmigrationusersetting')) {
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\preferences"
if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
New-ItemProperty -Path $key -Name 'newoutlookmigrationusersetting' -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\preferences"
if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
New-ItemProperty -Path $key -Name 'newoutlookmigrationusersetting' -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\preferences" Remove-ItemProperty -Path $key -Name 'newoutlookmigrationusersetting' -ErrorAction SilentlyContinue 'Policy values removed (Not configured).'
Intune (settings catalog)
Not found in the current settings catalog export. Search the catalog for Manage user setting for new Outlook automatic migration (Microsoft Outlook 2016 › Outlook Options › Other).
Cloud Policy
Cloud Policy (config.office.com → Customization → Policy Management) offers many user policies of the Microsoft 365 Apps – search for Manage user setting for new Outlook automatic migration. It also applies to unmanaged devices and wins over GPO and Intune for the same setting.
Microsoft 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.
Same category: Microsoft Outlook 2016 › Outlook Options › Other
- Do not download user photos from Active Directorydownloadphotosfromad
- Hide the Office Store buttonstorebuttoninribbonhometaballowed
- Hide photo linkhidephotolink
- Show Mini Toolbar on selectionallowselectionfloaties
- Do not display the reading panedisablereadingpane
- Empty the Deleted Items folder when Outlook closesemptytrash
- Make Outlook the default program for E-mail, Contacts, and Calendarcheck default client
- Reading Panepreviewmarkmessage
- Sort folders alphabeticallysortfoldersalphabetically
- Disable Preview Placedisablepreviewplace
- Disable online mode for Get Diagnostics.disableonlinemodeauthdiagnostics
- Disable Outlook Mobile Hyperlinkdisableoutlookmobilehyperlink
All policies in this category · All 406 policies of outlk16.admx