Upgrade distribution lists to Office 365 Groups in Outlook

Contributors: Diane Faigel
Last updated: 18 December, 2017

It's easy to upgrade distribution lists to Office 365 Groups in Outlook! This is a great way to give your organization's distribution lists all the features and functionality of Office 365 groups. Why you should upgrade your distribution lists to groups in Outlook

You can upgrade DLs one at a time, or several at the same time.

Upgrade one or many distribution lists to Office 365 Groups in Outlook

You must be an Office 365 global admin or Exchange admin to upgrade a distribution list.

  1. Sign in with your Office 365 admin account at https://aka.ms/admincenter.

    Sign in with your Office 365 admin account at https://portal.office.de/adminportal/home#/homepage.

    Sign in to Office 365 operated by 21Vianet.

  2. Go to Admin centers > Exchange.

  3. In the Exchange Admin Center, go to Recipients  >  Groups.

    You'll see a notice indicating you have distribution lists (also called distribution groups) that are eligible to be upgraded to Office 365 groups.

    Click on Get started.

  4. Select one or more distribution lists (also called a distribution group) from the groups page.

    Select a distribution group from the groups page
  5. Choose the upgrade icon.

    Click or tap the Upgrade to Office 365 groups icon
  6. On the information dialog, choose Yes to confirm the upgrade. The process begins immediately. Depending on the size and number of DLs you're upgrading, the process can take minutes or hours. 

    If the distribution list can't be upgraded, a dialog appears saying so. See Which distribution lists can be upgraded.

  7. If you're upgrading multiple distribution lists, use the drop down to filter which distribution lists have been upgraded. If the list isn't complete, wait a while longer and then choose Refresh to see what's been successfully upgraded.

    There's no notice that tells you when the upgrade process has completed for all DLs you selected. You can figure this out by looking to see what's listed under Available for upgrade or Upgraded DLs.

  8. If you selected a DL for upgrade, but it's still appears on the page as Available to upgrade, then it failed to upgrade. See What to do if the upgrade doesn't work.

Note: If you're getting the groups digest emails you may notice at the bottom that it will sometimes offer to let you upgrade any eligible distribution lists that you're the owner of. See Have a group conversation in Outlook for more information about digest emails.

What to do if the upgrade doesn't work

Distribution lists that fail to upgrade remain unchanged.

If one or more eligible distribution lists fail to be upgraded, open a Support ticket. The issue will need to be escalated to the Groups Engineering team for them to figure out the problem.

It's possible that the distribution list didn't get upgraded because of a service outage, but pretty unlikely. If you want, wait a while and then try to upgrade the DL again.

How to use PowerShell to upgrade several distribution lists at the same time

If you're experienced at using PowerShell, you might want to go this route instead of using the UI. We have a set of cmdlets that will help you upgrade distribution lists. See below.

Upgrade a single DL

To upgrade a single DL run the following command:

Upgrade-DistributionGroup –DlIdentities <Dl SMTP address>

For example, if you want to upgrade a DLs with SMTP address dl1@contoso.com, run the following command:

Upgrade-DistributionGroup –DlIdentities dl1@contoso.com

Note: You can also upgrade a single distribution list to an Office 365 group using the New-UnifiedGroup PowerShell cmdlet

Upgrade multiple DLs in a batch

You can also pass multiple DLs as a batch and upgrade them together:

Upgrade-DistributionGroup –DlIdentities <DL SMTP address1>, < DL SMTP address2>,

< DL SMTP address3>, < DL SMTP address 4>…………

For example, if you want to upgrade five DLs with SMTP address dl1@contoso.com and dl2@contoso.com, dl3@contoso.com, dl4@contoso.com and dl5@contoso.com, run the following command:

Upgrade-DistributionGroup –DlIdentities dl1@contoso.com, dl2@contoso.com, dl3@contoso.com, dl4@contoso.com, dl5@contoso.com

Upgrade all eligible DLs

There are two ways in which you can upgrade all the eligible DLs.

  1. Get the eligible DLs in the tenant and upgrade them using the upgrade command"

Get-EligibleDistributionGroup | Upgrade-DistributionGroup 

2. Get the list of all DLs and upgrade only the eligible DLs:

Get-DistribtuionGroup | Upgrade-DistributionGroup

FAQ about upgrading distribution lists to Office 365 Groups in Outlook

Which distribution lists can be upgraded?

You can only upgrade cloud-managed, simple, non-nested distribution lists. The table below lists distribution lists that CANNOT be upgraded.

Property

Eligible?

On-premises managed distribution list.

No

Nested distribution lists. Distribution list either has child groups or is a member of another group.

No

Distribution lists with member RecipientTypeDetails other than UserMailbox, SharedMailbox, TeamMailbox, MailUser

No

Distribution list which has more than 100 owners

No

Distribution list which only has members but no owner

No

Distribution list which has alias containing special characters

No

If the distribution list is configured to be a forwarding address for Shared Mailbox

No

If the DL is part of Sender Restriction in another DL.

No

Security groups

No

Dynamic Distribution lists

No

Distribution lists which were converted to RoomLists

No

How do I check which DLs are eligible for upgrade?

If you want to check whether a DL is eligible or not, you can run the below command:

            Get-DistributionGroup <DL SMTP address> | Get-EligibleDistributionGroup

If you want to check which DLs are eligible for upgrade just run the following command:

Get-EligibleDistributionGroup

Who can run the upgrade scripts?

People with Office 365 global admin or Exchange admin rights.

Why is the contact card still showing a distribution list? What should I do to prevent a upgraded distribution list from showing up in my auto suggest list?

  • For Outlook

    • When someone tries to send an email in Outlook by typing the Office 365 group name after migration, the recipient will be resolved as the distribution list instead of the Office 365 group. The contact card of the recipient will be the distribution lists contact card. This is because of the recipient cache or nick name cache in Outlook. The email will be sent successfully to the Office 365 group, but might cause confusion to the sender.

      You can perform the steps in this topic, Information about the Outlook AutoComplete list to reset the cache, which will fix this issue.

  • For Outlook on the web

Do new group members get a welcome email in their inbox?

No. The setting to enable welcome messages is set to false by default. This setting affects both existing and new group members who may join after the migration is complete. If the group owner later allows guest users, guest users won't receive a welcome email in their inbox. Guest members can continue working with the group.

What happens to the DL if the upgrade from EAC fails?

The upgrade will happen only when the call is submitted to the server. If the upgrade fails, your DLs will be intact. They will work like they used to.

The short icon for LinkedIn Learning. New to Office 365?
Discover free video courses for Office 365 admins and IT pros, brought to you by LinkedIn Learning.

Expand your Office skills
Explore training
Get new features first
Join Office Insiders

Was this information helpful?

Thank you for your feedback!

Thank you for your feedback! It sounds like it might be helpful to connect you to one of our Office support agents.

×