TeamsFixer

Tenant switch hangs or reverts to the original

You work with multiple organizations and the tenant switcher misbehaves. Exclamation marks on a tenant, switch silently reverts to the original, or a tenant is missing - all cases covered.

Last verified:

Affected systems

windows macos

Quick fixes

  • Clear cache and restart Teams
  • Use the web client - it is more reliable for tenant switching
  • Exclamation mark: sign out of the foreign tenant once, then click again
  • Reverts to original: clear browser cookies + keychain/credentials

How the switch should work

Top right next to your profile picture is the tenant name. A click opens a list of every organization where your account is a member or guest. Picking another tenant reloads Teams in that context.

Exclamation mark next to the tenant name

An exclamation mark in the switcher means: Teams cannot silently verify your session is still valid in that tenant. You must re-authenticate there actively.

What to do:

  1. Click the tenant with the exclamation mark - Teams should show an MFA prompt or login dialog
  2. Sign in / complete MFA - the exclamation mark should disappear
  3. If the click does nothing: open https://teams.microsoft.com in a browser, switch tenant there and re-authenticate - the desktop client inherits the session
  4. If the exclamation persists despite fresh sign-in: clear cache completely (see below)

Possible causes for the exclamation:

  • Refresh token expired in the foreign tenant
  • Conditional Access requires fresh MFA
  • Guest status temporarily restricted
  • Tenant requires a compliance check (device re-registration)

Switch reverts to the original tenant

Clicking another tenant kicks off loading, the welcome logo appears, then you end up back on the original tenant. There is no error, the switch simply gets undone silently.

This is a known SSO conflict in the desktop client:

  1. Clear cache fully (standard reset, see below)
  2. Browser cookies for login.microsoftonline.com and teams.microsoft.com
  3. Credentials / keychain scrubbed
  4. Reboot, reopen Teams
  5. Web as fallback: if desktop switching keeps reverting, switch tenant in the web browser - usually works immediately

Tenant is completely missing from the switcher

Empty list or the expected tenant does not appear:

  1. Teams has not yet synced memberships - wait 30 seconds
  2. Cache reset (below) - forces a fresh resync
  3. Check https://myaccount.microsoft.com/organizations - are you actually member/guest in that tenant?
  4. If guest invite expired: ask the admin of that org to send a fresh invite and accept it

Cache reset (your main hammer)

Windows

%appdata%\Microsoft\Teams
%localappdata%\Packages\MSTeams_8wekyb3d8bbwe\LocalCache

Delete both, quit Teams, relaunch.

macOS

~/Library/Application Support/Microsoft/Teams
~/Library/Group Containers/UBF8T346G9.com.microsoft.teams

Delete both, quit Teams, relaunch.

Mobile app is its own world

The Teams mobile app has its own tenant switcher. Often a tenant is missing on mobile but visible on desktop, or vice versa. Fix: reinstall the mobile app or re-add the missing tenant.

If the switcher is too flaky, force a tenant switch by clicking a recent meeting link from the inbox of the foreign tenant. Teams opens that tenant and remembers it in the switcher afterwards.

See also Tenant selectable but sign-in still fails.

Related errors