Changing between multiple Microsoft Teams accounts within the app or browser
Test one affected client account in Teams on the web alongside the Mac app: if both sessions require authentication after roughly one hour, the client organization’s administrator should review its Microsoft Entra session policies; if only the desktop app signs out, reset the new Teams cache on the Mac.
1. Determine whether the issue follows the account or the Mac app
- Sign in to one affected client account in a private browser window while keeping the same account open in the Teams desktop app.
- Note the start time and observe both sessions for longer than the usual one-hour interval.
- Record exactly what happens:
- Both web and desktop require sign-in again: likely an account/tenant authentication-policy issue.
- Only the desktop app loses the account: proceed with the local client reset below.
- The account disappears without any sign-in prompt or error: collect logs immediately before resetting anything.
Microsoft documents that modern authentication should normally avoid repeated credential prompts on the same Mac. Sign-in behavior can nevertheless vary with each organization’s authentication and MFA configuration.^1^
2. If it happens in both web and desktop Teams
Ask each affected client’s Microsoft 365/Entra administrator to review the sign-in records and Conditional Access policies for your account at the incident time. A Sign-in frequency session control can require periodic reauthentication, including a period expressed in hours; the Teams web client follows this setting.^2^
Send the administrator:
- Your affected account name.
- Exact local time and time zone of the sign-out.
- Whether it also occurred in Teams web.
- Any status code displayed on the sign-in screen.
- Whether only their organization’s account is affected.
If an error code appears, preserve it. Microsoft recommends giving that code to the organization’s IT administrator because many account- or tenant-level sign-in problems cannot be corrected from the client device.^3^
3. If only the Mac desktop app is affected
First collect logs, because clearing the cache deletes diagnostic data that may be needed to identify the problem. In Teams, select Help → Collect support files, or press Option+Command+Shift+1. Wait for the download banner to disappear; the files are saved in Downloads and include diagnostic information for all accounts currently signed in.^4^
Then reset the new Teams cache:
- Quit Teams completely with Command+Q.
- Open Finder → Applications → Utilities → Terminal.
- Run:
rm -rf ~/Library/Group\ Containers/UBF8T346G9.com.microsoft.teams
rm -rf ~/Library/Containers/com.microsoft.teams2
- Start Teams and add the accounts again.
Caution: these commands permanently delete local Teams cache and configuration data; they do not move it to Trash. They are Microsoft’s documented cache-reset commands for new Teams on macOS.^5^
If stale credentials remain, open Finder → Applications → Utilities → Keychain Access, locate the affected account, right-click it, and select Delete [account name]. Removing an account from macOS can also affect account access in other applications, because operating systems share accounts between apps for single sign-on.^6^
Avoid missed messages during diagnosis
For each client account, keep its Teams web session open in a separate browser profile and enable macOS notifications under System Settings → Notifications → Microsoft Teams → Allow Notifications.^7^
If the problem continues after the cache reset, provide the captured logs, incident timestamps, affected tenant/account, and any status code to the relevant client administrator or Microsoft Support.
References
- How different technologies affect Microsoft Teams sign-in
- Conditional Access: Session
- Why am I having trouble signing in to Microsoft Teams? | Microsoft Support
- Collect Teams client diagnostic logs for Microsoft support
- Clear the Teams client cache
- [Desktop](https://support.microsoft.com/teams/troubleshooting/sign-out-or-remove-an-account-from-microsoft-teams#remove-an-account-from-windows)
- Teams for Mac - Overview and prerequisites