Admin-Controlled Migration to New Outlook
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.
Registry
HKEY_CURRENT_USER\software\policies\microsoft\office\16.0\outlook\options\general- Value name
donewoutlookautomigration
| 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_DoNewOutlookAutoMigration
$k = 'HKCU:\software\policies\microsoft\office\16.0\outlook\options\general'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'donewoutlookautomigration' -Value 1 -Type DWordDisable
# Disable: outlk16/L_DoNewOutlookAutoMigration
$k = 'HKCU:\software\policies\microsoft\office\16.0\outlook\options\general'
if (-not (Test-Path -Path $k)) { New-Item -Path $k -Force | Out-Null }
Set-ItemProperty -Path $k -Name 'donewoutlookautomigration' -Value 0 -Type DWordRevert to "Not configured"
# Revert to "Not configured": outlk16/L_DoNewOutlookAutoMigration
$k = 'HKCU:\software\policies\microsoft\office\16.0\outlook\options\general'
Remove-ItemProperty -Path $k -Name 'donewoutlookautomigration' -ErrorAction SilentlyContinueApplication
Microsoft 365 Apps / Office (Microsoft) — November 2026 templates
Official templates downloaded on November 12, 2026.