End of availability for classic Teams client
Overview
A new Teams client is in the process of rolling out, in stages, for users who are still on classic Teams client. This rollout involves installing the new Teams client for users who still have the classic Teams client, with Microsoft attempting to uninstall the classic Teams client 14 days after the installation of new Teams. This article will discuss the timelines and details of end of support and end of availability for classic Teams client.
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:
The end of support for the classic Teams client starts July 1, 2024. The end of availability for the classic Teams client starts July 1, 2025.
VDI timeline:
Important
An updated VDI timeline for GCCH/DOD will be published soon.
The end of support for the classic Teams client in VDI starts October 1, 2024. The end of availability for the classic Teams client in VDI starts July 1, 2025.
For more information regarding VDI, see Upgrade to new Teams for Virtualized Desktop Infrastructure (VDI).
- Microsoft-managed rollout: If Teams policy was set to be Microsoft-controlled, new Teams will be rolled out according to the outlined schedule. We'll attempt to uninstall classic Teams after 14 days.
- Admin-managed rollout: Until the start of April, admins could choose to control the new Teams rollout as outlined in Upgrade to the new Teams client using policies. Apart from your VDI users, this has ended, and the following is now true:
- New Teams is installed and becomes the default client. The toggle to return to classic Teams is still 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 won't be available. We'll attempt to uninstall classic Teams after 14 days.
These are the important timeline concepts to remember going forward:
- End of support: The end of our supporting classic Teams client. We will no longer provide updates or new features for the client, nor will we help resolve support issues with the classic Teams client.
- End of availability: The end of functionality for the classic Teams client. After this deadline, the client will stop working and users will no longer be able to do work in the classic Teams client.
Timeline for GCC, GCCH, DoD
This rollout is going to differ based on your Teams Admin Center policy controls, as outlined in the following table:
Note
If you left the policy controls at their defaults state of Microsoft-controlled, we'll continue rolling out new Teams according to the schedule outlined in this article, but we won't proceed with the uninstallation of the classic Teams client for 14 days.
| Government cloud and scenario | Admin opt-in | New Teams toggle shown | New Teams default client | New Teams only |
|---|---|---|---|---|
| GCC/GCCH Microsoft-managed rollout | 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 in our Upgrade to the new Teams client using policies article. When the policy is enabled for a user, they can select the New Teams toggle switch in their Teams client to start the update. | Starting in late February, we enabled 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. | Beginning in late March, the new Teams client became 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. | 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. |
| GCC/GCCH admin-managed rollout | NA | NA | 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. | 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. |
| DOD Microsoft-managed rollout | 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 in our Upgrade to the new Teams client using policies article. When the policy is enabled for a user, they can select the New Teams toggle switch in their Teams client to start the update. | Starting in late February, we enabled 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. | Beginning in early May, the new Teams client became 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. | NA |
| DOD admin-managed rollout | NA | NA | 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. | 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 after 14 days. |
User experience
Classic Teams will reach the end of support starting July 1, 2024.
What users will experience after March 31, 2024
Starting in March 2024, any classic Teams users who hadn’t updated to new Teams began seeing an informational banner to remind them about the classic Teams end of support timeline. This banner appeared in the main Teams client window at the top of the page (underneath the main bar).
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 |
On July 1, 2024, classic Teams becomes unsupported. Users still running classic Teams due to configuration issues or an unsupported OS will experience in-app dialog messages informing them that the client is no longer supported. These dialogs are dismissible, but will reappear periodically.
Classic Teams End of availability
Unsupported OS
- Starting October 23, 2024, classic Teams won't be available on Windows 7, 8, and 8.1. If you use classic Teams on these systems, you'll see warning messages starting in August. On October 23, 2024, you won't be able to use the classic Teams app anymore. If you can't update your Windows to a supported browser, you can use the new Teams web app in a supported browser instead.
- Starting July 1, 2025, classic Teams will stop working on Windows 10, macOS older than Big Sur (11), LTSC, or for users with configuration issues. You'll see the in-app messages about classic Teams going away and you won't be able to use the classic Teams app after that date.
Users who can't upgrade to the new Teams client on their device can use the new Teams web app will be on supported browsers instead.
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 messages you may experience:
| Scenario | End of support warning | End of support | End of availability warning | End of availability |
|---|---|---|---|---|
| Unsupported operating system | Classic Teams will soon be unsupported, and your OS needs to be updated to run the new Teams. Starting July 1, 2024, we'll no longer be supporting classic Teams. Update your OS or contact your IT department. View minimum requirements | Classic Teams is no longer supported and your OS needs to be updated to run the new Teams. As of July 1, we're no longer supporting classic Teams. Update your OS or contact your IT department. View minimum requirements | Classic Teams will soon be unavailable, and your OS needs to be updated to run the new Teams. Starting July 1, 2025, classic Teams will no longer be available for use. Update your OS or talk to your IT department. View minimum requirements | Classic Teams is no longer available, and your OS needs to be updated to run the new Teams. As of July 1, 2025, classic Teams is no longer available for use. Update your OS or talk to your IT department. To experience the new Teams, you can try it out on the web. View minimum requirements |
| Windows GPO policy blocked users | Classic Teams will soon be unsupported, but due to org policy, we couldn't update you to the new Teams. Starting July 1, 2024, we'll no longer be supporting classic Teams. To update to the new Teams, contact your IT department. Learn about installation issues | Classic Teams is no longer supported, but due to org policy we couldn't update you to the new Teams. As of July 1, we're no longer supporting classic Teams. We couldn't update to the new Teams due to org policy. Contact your IT department. Learn more | Classic Teams will soon be unavailable, but due to org policy, we couldn't update you to the new Teams. Starting July 1, 2025, classic Teams will no longer be available for use. To update t othe new Teams, contact your IT department. Learn about installation issues | Classic Teams is no longer available, but due to org policy, we couldn't update you to the new Teams. As of July 1, 2025, classic Teams is no longer available for use. Contact your IT department for more info. To experience the new Teams, you can try it out on the web. Learn about installation issues |
| Any install and launch issues | Classic Teams will soon be unsupported, and we couldn't update you to the new Teams. Starting July 1, 2024, we'll no longer be supporting classic Teams. To update to the new Teams, contact your IT department. Learn about installation issues | Classic Teams is no longer supported, and we couldn't update you to the new Teams. As of July 1, we are no longer supporting classic Teams. We couldn't update to the new Teams. Contact your IT department. Learn more | Classic Teams will soon be unavailable, and we couldn't update you to the new Teams. Starting July 1, 2025, classic Teams will no longer be available for use. To update to the new Teams, contact your IT department. Learn about installation issues | Classic Teams is no longer available, and we couldn't update you to the new Teams. As of July 1, 2025, classic Teams is no longer available for use. Contact your IT department for more info. To experience the new Teams, you can try it out on the web. Learn about installation issues |
Classic Teams will remain available to use as defined in the timelines in this article. 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:
What happens if we can’t update users to new Teams
Once classic Teams isn't available for you, you're going to see a dialog similar to this one, and classic Teams won't work for you anymore.
Classic Teams users who've had issues moving to new Teams or who don't meet the prerequisites to upgrade will still have access to the classic Teams client until availability ends. After this time, users who can't upgrade on their devices can use the new Teams web app on a supported browser instead.
Admin experience
What admins saw 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 are experiencing after April 01, 2024
In the Teams admin center:
- Microsoft-managed rollout: If Teams policy was set to be Microsoft-controlled, new Teams will be rolled out according to the outlined schedule. We'll attempt to uninstall classic Teams after 14 days.
- Admin-managed rollout: Until the start of April, admins could choose to control the new Teams rollout as outlined in Upgrade to the new Teams client using policies. Apart from your VDI users, this has ended, and the following is now true:
- New Teams is installed and becomes the default client. The toggle to return to classic Teams is still 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 won't be available. We'll attempt to uninstall classic Teams after 14 days.
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for