Fix Teams Folder Is Missing From Files for an External Guest

External guests often cannot see the Teams folder in their Files tab. This happens when the guest has not accepted the sharing invitation or when the channel is private. The Teams folder appears only after the guest opens the channel and the system grants access to the shared document library. This article explains the root cause and shows the exact steps to restore the folder.

The Teams folder is a shortcut to the SharePoint document library behind each channel. When the shortcut fails to render, the guest sees an empty Files tab or a message that no files exist. The fix involves checking the guest’s access, reopening the channel, and verifying the library URL.

Below you will find the technical reason for the missing folder, a step-by-step repair process, related failure patterns, and a comparison of guest access levels.

Why the Teams Folder Does Not Appear for an External Guest

The Teams folder is not a real folder. It is a virtual shortcut that Teams creates in the Files tab. The shortcut points to the SharePoint document library of the channel. When a guest opens the channel, Teams requests a token for that library. If the token request fails, the folder does not render.

The most common cause is that the guest has not accepted the sharing invitation. When an external user is added to a team, they receive an email with a link. Until the guest clicks that link and signs in, the system does not create a valid user object for the guest. Without that object, SharePoint cannot grant access to the library, and the Teams folder stays hidden.

A second cause is the channel type. Private channels have their own SharePoint site and a separate document library. Guests must be explicitly added to a private channel. Being a member of the team does not automatically give access to private channel files.

A third cause is a policy that blocks guest access. The Teams admin can disable guest access for the entire tenant or for specific policies. When this happens, the guest sees the team but the Files tab shows no content.

How SharePoint Permissions Work for Guests

Every team has a connected SharePoint site. The site has a default document library named Shared Documents. When you open the Files tab in a channel, Teams displays a filtered view of that library. For guests, SharePoint uses the external sharing settings of the site.

If the site allows sharing with external users, the guest can access the library once they are added to the team. If the site restricts external sharing, the guest sees an error or an empty list.

Steps to Diagnose and Restore the Teams Folder for a Guest

1. Ask the guest to accept the sharing invitation
   Open the team in the Teams admin center and go to Users > Guests. Find the guest and check if they have accepted the invitation. If not, resend the invitation from the team member list. The guest must click the link and sign in with their Microsoft account.
2. Reopen the channel in Teams
   Have the guest select the team, then select the channel, and then select the Files tab. If the folder does not appear, close the channel and reopen it. This forces the client to request a new SharePoint token.
3. Open the SharePoint library directly
   Go to the team’s SharePoint site and copy the URL of the document library. Send that URL to the guest. If the guest can open the library in a browser, the problem is with the Teams client. If not, the problem is with permissions.
4. Verify the guest is a member of the channel
   For private channels, open the channel and select More options > Manage channel. Confirm the guest is listed. If not, add the guest to the channel.
5. Check external sharing settings
   In the SharePoint admin center, select the site and then go to Settings > External sharing. Make sure the level is set to Anyone with the link or Existing guests. If it is set to Only people in your organization, change it and save.
6. Clear the Teams cache
   On the guest’s Windows PC, close Teams and delete the cache files in %appdata%MicrosoftTeams. Then restart Teams. This removes any stale token that prevents the folder from loading.

If the Teams Folder Still Does Not Appear

Guest Sees an Empty Files Tab

An empty Files tab usually means the guest has no access to the SharePoint library. Check the site’s external sharing settings and the guest’s status in the team. If the guest was added but never accepted the invitation, they will have no permissions.

Guest Gets a Permission Error When Opening the Library

This error appears when the site restricts external sharing or when the guest is not in the site’s visitor group. Ask the team owner to check the site permissions and add the guest to the Visitors group.

Folder Appears on the Web but Not in the Desktop App

This is a client rendering issue. Clear the Teams cache or reinstall Teams. If the problem persists, use Teams on the web as a temporary workaround.

Guest Access Levels in Teams and SharePoint

Item	Team Member	External Guest
Default access to Shared Documents	Full access	Read and edit if invited
Can create new folders	Yes	No
Can upload files	Yes	Yes, if edit permission is granted
Access to private channels	Only if added	Only if added

The table shows that guests have limited capabilities. They can collaborate on files but cannot create new folders. If the Teams folder is missing, the issue is almost always about permissions or invitation acceptance.

After you complete the steps above, the guest should see the Teams folder in the Files tab. If the folder still does not appear, check the tenant-wide guest access policy in the Teams admin center. You can also use the SharePoint library URL as a reliable backup for file access.

For advanced troubleshooting, run the Teams network diagnostic tool on the guest’s machine. This tool checks connectivity to SharePoint and identifies token failures. You can also enable guest access for the entire tenant and then disable it for specific teams if you want tighter control.