How to Use a Custom Domain for a Synchronized Distribution Group in Microsoft 365
Question details
The user needs to configure an on-premises synchronized distribution group to use a specific custom domain instead of the default onmicrosoft.com routing address in Microsoft 365.

- Product
- Microsoft 365
- Device & OS
- not provided
- Scenario
- Synchronizing local Active Directory distribution groups with Microsoft 365 environments.
- Observed behavior
- The synchronized distribution group is incorrectly assigned an onmicrosoft.com email address due to missing or unmatched mail attributes.
Ensure you have Active Directory Administrator access on your local server and that the target custom domain is fully verified in your Microsoft 365 Admin Center.
Configure proxyAddresses and Perform SMTP Soft Matching
Update the local Active Directory attributes to include the correct primary SMTP address and force an Azure AD synchronization to soft match the group in Microsoft 365.
When you synchronize local Active Directory groups to Microsoft 365, the cloud environment relies on the local attributes to provision the email address. If the proxyAddresses attribute is missing or incorrectly formatted, Microsoft 365 will default to the tenant's onmicrosoft.com routing address.
Log in to your local Active Directory server, launch 'Active Directory Users and Computers' (ADUC), and ensure that 'Advanced Features' is enabled under the View menu.
Navigate to the Organizational Unit (OU) containing the affected distribution group, right-click the group, and select 'Properties'.
Switch to the 'Attribute Editor' tab, scroll down to find the 'proxyAddresses' attribute, and click 'Edit'.
Type the primary email address using the format 'SMTP:groupname@yourcustomdomain.com'. Ensure that 'SMTP' is entirely in uppercase, which designates it as the primary routing address, then click 'Add' and 'OK'.
Open PowerShell on your Azure AD Connect server and run 'Start-ADSyncSyncCycle -PolicyType Delta' to push the updated attributes to Microsoft 365.
Log into the Microsoft 365 Admin Center, navigate to 'Teams & groups' > 'Active teams and groups', select the 'Distribution list' tab, and confirm that the primary email address now reflects your custom domain.

Looking for a Lightweight Office Suite Alternative?
While managing complex server synchronizations requires specialized Microsoft Admin tools, creating and sharing daily reports, documentation, or spreadsheets doesn't have to be complicated or expensive. WPS Office is a free, comprehensive office suite that provides a seamless user experience for your everyday administrative documentation needs.
- 1. Download WPS Office: Visit the official WPS website to download the free installation package tailored for your operating system.
- 2. Install the Software: Run the installer and follow the simple on-screen instructions to complete the setup in just a few clicks.
- 3. Open Your Documents: Launch WPS Office and directly open your existing Microsoft Office files without needing any format conversion.

Frequently Asked Questions
Why does my distribution group default to an onmicrosoft.com address?
This typically happens when the on-premises Active Directory distribution group lacks the necessary mail attributes—particularly a properly formatted proxyAddresses entry—prior to being synchronized with Microsoft 365.
What is an SMTP match (soft match) in Microsoft 365?
SMTP matching, or soft matching, is a synchronization process where Azure AD Connect links an on-premises user or group account to an existing cloud account based on their matching primary SMTP email address.
Can I edit the distribution group's email address directly in Microsoft 365?
No. If a distribution group is synchronized from an on-premises Active Directory, its attributes are locked in the cloud. All modifications to email addresses and memberships must be performed locally in Active Directory and then synchronized.
How long does it take for the custom domain to appear after a sync?
Once the delta sync cycle is successfully completed on your Azure AD Connect server, the changes usually reflect in the Microsoft 365 Admin Center within a few minutes, although larger directories might take slightly longer.




