Microsoft Account Errors

Change a Synced User’s Primary Email Address in Microsoft 365

Rana GarciaRana Garcia Nov 20, 2026 869 views

Question details

Change a synchronized Microsoft 365 user’s primary email address from an onmicrosoft.com address to a custom-domain address.

Change a Synced User’s Primary Email Address in Microsoft 365
Product
Microsoft 365 and on-premises Active Directory
Device & OS
not provided
Scenario
A directory-synchronized user’s address appears in the Microsoft 365 global address book with the onmicrosoft.com domain.
Observed behavior
The relevant user fields are disabled in the Microsoft 365 portal because they are controlled by directory synchronization.
Before you start

Confirm that the custom domain is verified in Microsoft 365 and that the desired email address is not assigned to another recipient. Use an account with permission to edit the user in on-premises Active Directory, and check whether Exchange management tools or an email address policy control the recipient’s addresses.

Solution 1Recommended

Update the Primary Email Address in On-Premises Active Directory

Use this method when the user’s email attributes are synchronized from on-premises Active Directory.

The primary email address is identified by an uppercase SMTP: prefix in proxyAddresses; lowercase smtp: entries are aliases. The userPrincipalName controls the sign-in name and does not by itself set the primary email address.

If the recipient is managed through on-premises Exchange, use the supported Exchange management tools to change its email addresses rather than editing Exchange attributes directly in Active Directory.

1
Open the user’s attributes

Open Active Directory Users and Computers, select View > Advanced Features, navigate to the user’s organizational unit, and open the user’s Properties > Attribute Editor.

2
Set the primary address

Edit proxyAddresses. Set the desired custom-domain address as SMTP:user@example.com, using the user’s actual address. Change any previous uppercase SMTP: entry to lowercase smtp: if it should remain as an alias. Keep only one uppercase SMTP: entry.

3
Update the mail attribute

In Attribute Editor, set the mail attribute to the same custom-domain address without the SMTP: prefix, then apply the changes.

4
Review the sign-in name

If the user’s sign-in name also needs to change, update userPrincipalName in Attribute Editor or the User logon name on the Account tab. Do not change it solely to set the primary email address.

5
Synchronize and verify

Wait for the next Microsoft Entra Connect synchronization cycle. If authorized, run Start-ADSyncSyncCycle -PolicyType Delta in PowerShell on the sync server. Then check the user’s email addresses in the Microsoft 365 admin center and allow time for the global address book to update.

If the address does not change: Check for duplicate addresses, synchronization errors, and Exchange email address policies that may overwrite the setting. If Outlook still shows the old address, allow time for its offline address book to refresh.
Free Microsoft Office alternative

Work With Office Files in WPS Office

WPS Office is a free, lightweight alternative for working with documents, spreadsheets, and presentations. Its familiar interface and Microsoft Office format compatibility make it easy to move existing files, although it cannot change Microsoft 365 directory settings.

Use WPS Office without changing Microsoft 365 directory settingsOpen and edit Microsoft Word, Excel, and PowerPoint formatsNavigate documents with a familiar Office-style interfaceMove existing Office files into a lightweight workspace
microsoft office alternative - wps office

Frequently Asked Questions

Why are the user’s email fields disabled in Microsoft 365?

Directory synchronization controls those fields from on-premises Active Directory. Make the change in the source directory or, for Exchange-managed recipients, through the supported on-premises Exchange management tools.

What is the difference between SMTP and smtp in proxyAddresses?

An uppercase SMTP: prefix identifies the primary email address. Lowercase smtp: prefixes identify aliases. A user should have only one uppercase SMTP: entry.

Do I need to change the user’s sign-in name too?

No. The userPrincipalName is the sign-in name and can differ from the primary email address. Change it only if the sign-in name also needs to use the custom domain.

How can I start synchronization after making the change?

On the Microsoft Entra Connect sync server, an authorized administrator can run Start-ADSyncSyncCycle -PolicyType Delta in PowerShell, or wait for the next scheduled cycle. The global address book may take additional time to update.

What should I check if the old address still appears?

Check for duplicate recipient addresses, synchronization errors, and an Exchange email address policy that may overwrite the change. If the address is correct online but Outlook shows the old one, allow time for the offline address book to refresh.