Others

How to Use a Custom Domain for a Synchronized Distribution Group in Microsoft 365

Tauseeq MagsiTauseeq Magsi Nov 3, 2026 869 views

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.

How to Use a Custom Domain for a Synchronized Distribution Group 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.
Before you start

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.

Solution 1Recommended

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.

1
Open Active Directory Users and Computers

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.

2
Locate the Distribution Group

Navigate to the Organizational Unit (OU) containing the affected distribution group, right-click the group, and select 'Properties'.

3
Edit the proxyAddresses Attribute

Switch to the 'Attribute Editor' tab, scroll down to find the 'proxyAddresses' attribute, and click 'Edit'.

4
Add the Custom Domain Address

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'.

5
Run Azure AD Connect Synchronization

Open PowerShell on your Azure AD Connect server and run 'Start-ADSyncSyncCycle -PolicyType Delta' to push the updated attributes to Microsoft 365.

6
Verify the Change

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.

Configure proxyAddresses and Perform SMTP Soft Matching
Attribute Precedence: If you add multiple email addresses to the proxyAddresses list, any address prefixed with lowercase 'smtp:' will be treated as an alias. Only the address with uppercase 'SMTP:' will become the primary address.
Free Microsoft Office alternative

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. 1. Download WPS Office: Visit the official WPS website to download the free installation package tailored for your operating system.
  2. 2. Install the Software: Run the installer and follow the simple on-screen instructions to complete the setup in just a few clicks.
  3. 3. Open Your Documents: Launch WPS Office and directly open your existing Microsoft Office files without needing any format conversion.
Fully compatible with Microsoft Word, Excel, and PowerPoint formats (.docx, .xlsx, .pptx).Lightweight installation package with exceptionally fast startup times.Built-in robust PDF editing tools for secure server documentation sharing.Familiar tabbed interface making software migration seamless and easy.
microsoft office alternative - wps office

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.