Change a Synced User’s Primary Email Address in Microsoft 365
Question details
Change a synchronized Microsoft 365 user’s primary email address from an onmicrosoft.com address to a custom-domain address.

- 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.
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.
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.
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.
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.
In Attribute Editor, set the mail attribute to the same custom-domain address without the SMTP: prefix, then apply the changes.
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.
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.
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.

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.




