Fix Teams Files Tab Will Not Open after a SharePoint Site Rename

When you rename a SharePoint site that backs a Teams team, the Files tab in Teams can stop opening and show an error or a blank page. This happens because Teams stores the old site URL in its internal configuration, and the renamed site breaks the link. This article explains why the rename breaks the Files tab and gives you a step-by-step fix to restore access without losing any data.

You will learn how to correct the broken link using the SharePoint admin center and how to avoid the problem in future renames. The fix takes about ten minutes and does not require you to recreate the team or re-upload any files.

Why a SharePoint Site Rename Breaks the Teams Files Tab

Each Microsoft Teams team is connected to a SharePoint site that stores all channel files. When you rename that site, SharePoint changes the site’s URL from something like contoso.sharepoint.com/sites/OldName to contoso.sharepoint.com/sites/NewName. Teams, however, keeps the old URL in its internal site collection mapping. When you click the Files tab, Teams tries to open the old URL, which no longer exists, so the tab fails to load.

The rename itself does not move or delete any files. The files remain intact on the SharePoint site. The problem is purely a broken link between the Teams client and the new site address.

In some cases, the Teams desktop client caches the old URL locally. Even after you fix the server-side link, the client might still show the error until you clear the cache or restart Teams.

What Happens to the Files When You Rename a Site

When you rename a SharePoint site, the underlying document library and all its contents keep their internal GUIDs. The URLs change, but the file structure stays the same. This means no data is lost during the rename, and you can safely restore the link without affecting any documents.

Steps to Fix the Files Tab After a SharePoint Site Rename

The fix has two parts. First, you update the SharePoint site URL to match what Teams expects. Second, you clear the Teams cache on the affected user’s device. Follow these steps in order.

1. Open the SharePoint admin center
   Go to admin.microsoft.com and sign in with an account that has SharePoint admin or Global admin permissions. In the left navigation, select SharePoint to open the SharePoint admin center.
2. Find the renamed site
   In the SharePoint admin center, select Active sites from the left menu. Use the search box to find the site that was renamed. The site name will match the team name, but the URL may be different.
3. Check the current site URL
   Look at the URL column for the site. Note the full URL. If it ends with /sites/NewName, that is the new address after the rename.
4. Change the site URL back to the original
   Select the site by clicking the checkbox next to it. In the command bar, choose Change site address. Enter the original URL that Teams still expects, for example https://contoso.sharepoint.com/sites/OldName. Click Save and confirm any warning prompts. SharePoint will apply the change within a few minutes.
5. Verify the link in Teams admin center
   Open the Teams admin center at admin.teams.microsoft.com. Go to Teams > Manage teams. Find the affected team and look at the Site URL column. It should now match the original URL you set in step 4. If it does not, you may need to use PowerShell to update the group’s SharePoint site URL, but this is rare.
6. Clear the Teams cache on the user’s device
   On the computer where the Files tab fails, close Teams completely. Right-click the Teams icon in the system tray and choose Quit. Then open File Explorer and navigate to %appdata%\Microsoft\Teams. Delete the contents of the following folders: Cache, Code Cache, GPUCache, and blob_storage. Do not delete the entire Teams folder, only these subfolders.
7. Restart Teams and test the Files tab
   Open Teams again and sign in. Go to the team’s channel and click the Files tab. The tab should now load the document library correctly. If it still fails, sign out of Teams and sign back in to force a full refresh.

If the Files Tab Still Has Issues After the Fix

Sometimes the basic fix is not enough, especially if the rename happened long ago or if multiple users are affected. Here are common follow-up problems and how to solve them.

Teams Files Tab Shows a Blank Page After the URL Change

A blank page usually means the Teams client has not refreshed its cached site mapping. Clear the Teams cache again using the steps above, then restart Teams. If the problem persists, try opening the Files tab in the Teams web app at teams.microsoft.com. If it works there, the desktop client cache is the culprit.

Users See a Permission Error When Accessing the Files Tab

If you changed the site URL back to the original, but users still get a permission error, the site’s permissions may have been altered during the rename. Go to the SharePoint site, select Settings > Site permissions, and verify that the team’s members group still has access. Re-add the group if it is missing.

You Cannot Rename the Site Back Because the Original URL Is Taken

If another site now uses the original URL, you cannot simply change the address back. In that case, you must update the Teams group’s linked SharePoint site URL using PowerShell. Connect to SharePoint Online PowerShell and run the Set-SPOSite cmdlet with the -Url parameter to point the group to the new site address. This is an advanced step and should be done by an administrator experienced with PowerShell.

New Teams Desktop vs Teams on the Web: Which Fixes the Files Tab Faster

Item	New Teams Desktop	Teams on the Web
Cache refresh	Requires manual cache deletion	Refreshes on page reload
URL mapping update	Picks up server changes after restart	Picks up server changes immediately
Best for testing	After clearing cache	As a quick diagnostic tool

Use Teams on the web to verify that the server-side fix worked. If the Files tab loads in the browser but not in the desktop app, the problem is the local cache. Clear the cache on the desktop app to complete the fix.

Conclusion

You can now fix a broken Teams Files tab after a SharePoint site rename by changing the site address back to the original URL and clearing the Teams cache. Always verify the link in the Teams admin center after the change. If you rename sites in the future, inform users to close and reopen Teams so the client refreshes its cached URL. For advanced cases, use the SharePoint Online PowerShell module to update the site URL directly.