End of availability for classic Teams client

Overview

After March 31 2024, a new Teams client will be rolled out, in stages, for users who are still on classic Teams. The roll out means installing the new Teams client for users who still have the classic Teams client, and uninstalling the classic Teams client 14 days after the installation of new Teams.

Timeline updates

This rollout is going to differ based on your Teams Admin Center policy controls.

Important

These timelines don't apply to GCC, GCCH, and DoD. We cover this in a later section.

Native clients excluding VDI:

A chart showing the timelines for classic Teams to new Teams.

VDI timeline:

A chart showing the timelines for classic Teams to new Teams for VDI.

For more information regarding VDI, please see Upgrade to new Teams for Virtualized Desktop Infrastructure (VDI).

Note

The unavailability of classic Teams and dates mentioned in this article don't currently apply to Windows 10 users signed into Teams for Life or users signed into both Teams for Life and Teams for Work.

  • Microsoft-managed rollout: If you left the policy controls at their defaults state of Microsoft-controlled, we'll continue rolling out new Teams as per the schedule outlined above, with one update: We won't proceed with the uninstallation of the classic Teams client for 14 days.
  • Admin-managed rollout: Admins can choose to control the new Teams rollout as outlined in Upgrade to the new Teams using policies. These policies will no longer be honored at the start of April, apart from your VDI users, and the following changes will happen:
    • New Teams will be installed and become the default client. The toggle to return to classic Teams will still be available if needed.
    • In mid-May, any users remaining on classic Teams will be switched to new Teams, and the toggle to return to classic Teams will no longer be available. We'll attempt to uninstall classic Teams, currently after a period of 14 days.

Important

Classic Teams users who have encountered issues moving to new Teams or who don't meet the prerequisites to upgrade will still have access to the classic Teams client until July 01 2024 at the earliest. This gives admins more time to address any issues encountered during this process.

Timeline for GCC, GCCH, DoD

This rollout is going to differ based on your Teams Admin Center policy controls.

GCC/GCCH

  • Microsoft-managed rollout: If you left the policy controls at their default state of Microsoft-controlled, we'll continue rolling out new Teams as follows, keeping in mind that we won't proceed with the uninstallation of the classic Teams client for 14 days.
    • Admin opt-in: Currently, the new Teams update will only be available when administrators enable it for their users. (Instructions for configuring policy for the new Teams client can be found here: Upgrade to the new Teams client using policies - Microsoft Teams | Microsoft Learn) When the policy is enabled for a user, they may then select the New Teams toggle switch in their Teams client to initiate the update.
    • New Teams toggle shown: Starting in late February, we will enable the new Teams toggle for Microsoft-controlled users. If they are still using the classic Teams client, they will not be updated unless they toggle the switch.
    • New Teams becomes the default Client: Beginning in late March, the new Teams client will become the default client for Teams users. Customers will receive the new Teams update, unless disallowed by policy. (Users may still toggle back to the classic Teams client.)
    • New Teams only: Beginning in early May all remaining classic Teams users will be updated to the new Teams client and the toggle switch will be removed. After this process completes, Microsoft will attempt to remove the classic Teams client.
  • Admin-managed rollout:
    • New Teams becomes the default client. Beginning in late May, the new Teams client will become the default client for all active Teams users. Customers will receive the new Teams update. Users may still toggle back to the classic Teams client.
    • New Teams Only. Beginning mid-June all remaining classic Teams users will be updated to the new Teams client and the toggle switch will be removed. After this process completes, Microsoft will attempt to remove the classic Teams client.

In April, we'll have guidance on end of support policies for the classic Teams client.

DoD

Starting in mid-July, Teams update policies you've applied in Teams Admin Center will no longer be honored and a Microsoft-controlled rollout will begin according to the following schedule.

  • Microsoft-managed rollout: If you left the policy controls at their defaults state of Microsoft-controlled, we'll continue rolling out new Teams as per the schedule outlined previously, with one update: We won't proceed with the uninstallation of the classic Teams client for 14 days.
    • Admin opt-in: Currently, the new Teams update will only be available when administrators enable it for their users. (Instructions for configuring policy for the new Teams client can be found here: Upgrade to the new Teams client using policies - Microsoft Teams | Microsoft Learn) When the policy is enabled for a user, they may then select the New Teams toggle switch in their Teams client to initiate the update.
    • New Teams toggle shown: Starting in late March, we will enable the new Teams toggle for Microsoft-controlled users. If they're still using the classic Teams client, they will not be updated unless they toggle the switch.
    • New Teams becomes the default Client: Beginning in early May, the new Teams client will become the default client for Teams users. Customers will receive the new Teams update, unless disallowed by policy. (Users may still toggle back to the classic Teams client.)
  • Admin-managed rollout: New Teams only: Beginning in early June all remaining classic Teams users will be updated to the new Teams client and the toggle switch will be removed. After this process completes, Microsoft will attempt to remove the classic Teams client. Admin-managed tenants. Admins may choose to control their new Teams rollout by setting the Teams updates policy for their users (as described in: Upgrade to the new Teams client using policies - Microsoft Teams | Microsoft Learn.) Admins may control the Teams update policy until mid-July.
    • New Teams becomes the default client. Beginning in mid-July, the new Teams client will become the default client for all active Teams users. Customers will receive the new Teams update. Users may still toggle back to the classic Teams client.
    • New Teams Only. Beginning mid-August all remaining classic Teams users will be updated to the new Teams client and the toggle switch will be removed. After this process completes, Microsoft will attempt to remove the classic Teams client.

In April, we'll have guidance on end of support policies for the classic Teams client.

User experience

What users will experience after March 31 2024

Starting in March 2024, any classic Teams users who haven’t updated to new Teams will begin seeing an informational banner to remind them about the timeline for the Microsoft AutoUpdate. This banner will appear in the main Teams client window at the top of the page (underneath the main bar).

Shows the banner in Teams client that reads 'Classic Teams won't be available. You'll be switched to the new Teams after availability ends. Switch now.' Switch now is a selectable link.

Note

You can dismiss this banner when it starts to appear, but the banner will reappear with each client launch.

Here's a list of the banner messages you may experience:

Condition for triggering the banner Banner message Further information
Classic Teams is being used or new Teams is installed Classic Teams will soon be unavailable for use. You’ll be switched to the new Teams after this date. Learn More. Switch now
Classic Teams is being used. new Teams isn't installed Classic Teams will soon be unavailable. Learn more Get the new Teams
Microsoft can't update because of policy restrictions (Commercial) Classic Teams will soon be unavailable for use, and we can't update to the new Teams due to org policy. For more info, contact your IT admin. Learn more Troubleshooting installation issues in the new Teams client
If your Teams update policy is set to Not enabled Classic Teams will soon be unavailable for use. Contact your IT admin to switch to the new Teams. Learn more Classic Teams users to be updated to new Teams after March 31, 2024

Classic Teams will remain available to use as per defined in the above timelines. However, we highly encourage admins to update their users to new Teams, as new features are only being added to the new Teams client. Learn more in the Upgrade to the new Teams using policies article.

If users are on an unsupported OS (including Win 10 LTSC), you’ll see a slightly different banner messaging:

Shows the banner in Teams client that reads 'Classic Teams won't be available for use after the end of the availability period. To use the new Teams, update your OS to meet requirements or contact your IT Admin.' the requirements link is a selectable link.

If we're unable to move you to new Teams, here's a list of the banner messages you may experience:

Condition for triggering the banner Banner message Further information
Unsupported Windows operating system Classic Teams will soon be unavailable for use. To use the new Teams, update your OS to meet requirements or contact your IT admin. Learn more. Prerequisites
Unsupported Mac operating system Classic Teams will soon be unavailable for use. To use the new Teams, update your OS to meet requirements or contact your IT admin. Learn more. Prerequisites
Unsupported operating system (EDU) Classic Teams will soon be unavailable for use. To use the new Teams, update your OS to meet requirements or contact your IT admin. Learn more. Prerequisites
Unsupported operating system (Gov) Classic Teams will soon be unavailable for use. To use the new Teams, update your OS to meet requirements or contact your IT admin. Learn more. Prerequisites
Unsupported operating system (DOD) Classic Teams will soon be unavailable for use. To use the new Teams, update your OS to meet requirements or contact your IT admin. Learn more. Prerequisites
Microsoft 365 operated by 21Vianet in China Classic Teams will soon be unavailable for use. To use the new Teams, update your OS to meet requirements or contact your IT admin. Learn more. Prerequisites
Unsupported OS (VDI) Classic Teams will soon be unavailable for use. Contact your IT admin to switch to the new Teams. Learn more. Prerequisites
Microsoft can't update because of policy restrictions (EDU) Classic Teams will soon be unavailable for use, and we can't update to the new Teams due to org policy. For more info, contact your IT admin. Learn more

What happens if we can’t update users to new Teams

Once classic Teams is no longer available for you, you're going to see a dialog similar to this one, and classic Teams won't work for you anymore.

Teams dialog box that appears after classic Teams no longer works, if you're unable to be updated to the new Teams client. The notification box has a link to requirements and a button that takes you to Teams on the web.

Classic Teams users who have encountered issues moving to new Teams or who don't meet the prerequisites to upgrade will still have access to the classic Teams client until July 01 2024 at the earliest. This gives admins more time to address any issues encountered during this process. We do ask that users update their OS and address any other issues to continue using the Teams client after this time, as new features are only being added to the new Teams client.

Admin experience

What admins will see until the end of March 31 2024

Admins have full control over their tenant’s transition to new Teams via the Upgrade to the new Teams using policies article.

A bulk installer, including offline capability, is provided for admins who want to deploy new Teams using their own tools and process and use Teams policies to move their users to the desired experience: Bulk upgrade to the new Microsoft Teams client.

Microsoft highly recommends that admins who want more control or a more gradual rollout of new Teams take advantage of these tools and functionality to begin slowly transitioning their users to new Teams now. Policies can be targeted to individual users, groups of users, or your entire tenant to give you flexibility to release to users group by group while monitoring progress and feedback.

What admins will experience after April 01 2024

In the Teams admin center:

  • Microsoft-managed rollout: If you left the policy controls at their defaults, we'll continue rolling out new Teams as per the schedule previously outlined, with one update: We won't proceed with the uninstallation of the classic Teams client for 14 days.
  • Admin-managed rollout: Admins can choose to control the new Teams rollout as outlined in Upgrade to the new Teams using policies. These policies will no longer work at the start of April, apart from your VDI users, and the following changes will happen:
    • New Teams will become the default client. The toggle to return to classic Teams will still be available if needed.
    • In mid-May, new Teams will be installed, and the toggle to return to classic Teams will no longer be available. We'll attempt to uninstall classic Teams, currently after a period of 14 days.

Frequently Asked Questions

Users

  • If a user has both clients installed: Only new Teams will work after the end of availability, and we'll attempt to uninstall the classic Teams client after 14 days.
  • If only the new Teams client is installed: There won’t be any difference.
  • If a user can’t install the new Teams client due to a reason outlined in the previous table, such as unsupported OS (including Win 10 LTSC): These users will be allowed to use classic Teams until June 30, 2024 to allow for updating operating system to modifying permissions etc. After June 30 2024, classic Teams won't work.

Admins

  • The system requirements for the new Teams client: Prerequisites.
  • When will admins see the new Teams Only policy in their tenant: This is available in the Teams admin center now. Please see Upgrade to the new Teams using policies.
  • What will happen with the update policies: The update policies may still appear, but they won’t be functional after March 31, 2024, except for VDI customers.
  • When will classic Teams client stop being installed with M365 apps: The installation of the classic Teams client will stop happening at the end of the availaibility period.
  • Can I stop the classic Teams client from being uninstalled and what happens if a policy is set to prevent app uninstallation: Yes, you can stop the classic Teams client from being uninstalled. If your configuration prevents uninstall, Microsoft won't attempt the uninstall again. You'll need to uninstall classic Teams after that point.
  • Do I need to remove the old client: Microsoft recommends that you remove the classic Teams client once a user is fully transitioned to new Teams. It's security best practice to not leave software that is no longer operational installed on a machine. Microsoft will attempt to remove the classic Teams client on your behalf, but if your configuration or policies are blocking or preventing this uninstall it's your responsibility to do this removal yourself.
  • What can I do if users still need the classic Teams client: You won’t be able to use classic Teams once availability ends, or June 30 2024 if you meet the conditions in the table at the start of the article. Until that date you'll still have a banner announcing the end of classic Teams at the top of your client. For more information review: Features that are changing in the new Microsoft Teams.
  • Are there any scripts available if the admin needs to bulk uninstall the classic Teams client: Check out our uninstallation documentation.

Client

  • Will the classic Teams client be removed automatically: Microsoft will attempt to uninstall classic Teams after the availability period ends. If this fails, admins must uninstall classic Teams for their users. You can find more information on uninstallation in this article.
  • When or how will it be removed, and what triggers the uninstall: This removal will happen after the availability period ends. As each user receives the automatic update and switches to new Teams, an attempt will be made to uninstall classic Teams.
  • Will the classic Teams client be removed for all users on the device: Yes.
  • Will both Windows and Mac support uninstallation: Yes.
  • What if I need to use the classic Teams client after the availability period: You won’t be able to use classic Teams after the availability period ends, or June 30 2024 if you meet the conditions in the table at the start of the article. Until that date you'll still have a banner announcing the end of classic Teams at the top of your client. For more information, see Features that are changing in the new Microsoft Teams.
  • Will I be able to download the classic Teams client after the availability period ends: Yes, but it won't be functional unless you meet one of the conditions to extend classic Teams functionality until June 30 2024.

VDI

  • Will the earlier date apply to users on VDI devices: No, the June 30 2024 date applies to users on VDI devices.