Admin-Controlled Migration to New Outlook
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 | donewoutlookautomigration |
| Group Policy | Admin-Controlled Migration to New Outlook |
| German version | Vom Administrator kontrollierte Migration zum neuen Outlook |
| Intune settings catalog | Admin-Controlled Migration to New Outlook (User) |
| Scope | User · HKCU |
| ADMX | outlk16.admx · L_DoNewOutlookAutoMigration |
Group Policy path
Registry
| Value | Data |
|---|---|
HKCU\Software\policies\microsoft\office\16.0\outlook\options\general | |
| donewoutlookautomigration | 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\options\general"
foreach ($name in @('donewoutlookautomigration')) {
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\options\general"
if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
New-ItemProperty -Path $key -Name 'donewoutlookautomigration' -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\options\general"
if (-not (Test-Path $key)) { New-Item -Path $key -Force -ErrorAction Stop | Out-Null }
New-ItemProperty -Path $key -Name 'donewoutlookautomigration' -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\options\general" Remove-ItemProperty -Path $key -Name 'donewoutlookautomigration' -ErrorAction SilentlyContinue 'Policy values removed (Not configured).'
Intune (settings catalog)
Admin-Controlled Migration to New Outlook (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_OutlookOptions~L_Other/L_DoNewOutlookAutoMigration |
| 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 Admin-Controlled Migration to New Outlook. It also applies to unmanaged devices and wins over GPO and Intune for the same setting.
Microsoft explanation
This policy controls the ability of IT admins to initiate the migration of users from classic Outlook to new Outlook.
If you enable this policy setting, IT admins will start the process to switch users from classic Outlook to new Outlook.
If you disable this policy setting, the migration process to new Outlook will be stopped, keeping users on their current version of Outlook without transitioning to new Outlook.
If you do not set this policy setting, the migration process to new Outlook will not start, and users that have not migrated will remain on classic Outlook.
Note: IT admins can also define intervals for re-initiating the migration process for users who revert to classic Outlook from new Outlook. This is managed through the NewOutlookAutoMigrationRetryIntervals policy, offering a tailored strategy for transitioning users based on organizational requirements and user feedback.
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