When you rename a SharePoint site that hosts a Teams wiki, the wiki tab can show a blank page or an error that the content is missing. This happens because Teams stores the wiki in a hidden OneNote notebook inside the site’s document library, and the rename breaks the link that Teams uses to open that notebook. This article explains the root cause and provides step-by-step instructions to restore your wiki content. You will also learn how to prevent this issue when renaming sites in the future.
Key Takeaways: Restore a Teams Wiki After a SharePoint Site Rename
- Teams admin center > Teams apps > Manage apps: Verifies that the Wiki app is enabled and available for your tenant.
- SharePoint site URL and OneNote notebook path: Identifies the exact location where the wiki content is stored.
- OneNote desktop app or OneNote online: Opens the hidden notebook to confirm that the content still exists.
Why a SharePoint Site Rename Breaks the Teams Wiki
The Teams wiki is not a separate database. Each wiki tab is a OneNote notebook stored in the Teams Wiki Data folder inside the site’s document library. When you rename a SharePoint site, the site’s URL changes. Teams stores the notebook’s URL in its internal configuration. After the rename, the old URL no longer points to the notebook, so Teams cannot load the content.
The rename can also affect the notebook’s name and the folder structure. SharePoint may update the notebook path to reflect the new site name, but Teams does not always refresh its cached link. This mismatch causes the wiki tab to display a blank page or an error message that says the content is unavailable.
What Exactly Changes in SharePoint
When you rename a site, SharePoint changes the site URL from something like contoso.sharepoint.com/sites/OldName to contoso.sharepoint.com/sites/NewName. The document library that contains the wiki notebook remains the same, but the notebook’s internal URL changes. Teams uses the old URL to open the notebook, so the link breaks. The actual notebook file is not deleted. The content is still there, but Teams cannot find it.
Steps to Restore the Wiki Content After a Site Rename
Follow these steps to recover your wiki content. You need SharePoint site owner permissions and access to the Teams team where the wiki tab exists.
Step 1: Verify That the Wiki App Is Enabled
- Open the Teams admin center
Go to Teams admin center > Teams apps > Manage apps. Search for the Wiki app and confirm that its status is Allowed. If it is blocked, select it and choose Allow. - Check the app setup policy
Go to Teams admin center > Teams apps > Setup policies. Ensure that the policy assigned to your users includes the Wiki app. If not, edit the policy and add the Wiki app to the allowed apps list.
Step 2: Locate the Wiki Notebook in SharePoint
- Open the SharePoint site
Go to the SharePoint site that was renamed. Use the new URL. If you do not know the new URL, ask your SharePoint admin. - Navigate to the document library
Select Documents in the left navigation. Look for a folder named Teams Wiki Data. Open that folder. - Find the notebook
Inside the folder, you should see a file with a name like Wiki – TeamName. This is the OneNote notebook that contains your wiki content.
Step 3: Open the Notebook to Confirm the Content
- Open the notebook in OneNote online
Select the notebook file and click Open in the preview pane. This opens the notebook in OneNote online. You should see all your wiki pages in the left navigation. - If the notebook does not open
Download the notebook to your computer and open it with the OneNote desktop app. If the notebook opens there, the content is intact.
Step 4: Recreate the Wiki Tab and Copy the Content
- Delete the broken wiki tab
In Teams, go to the channel that contains the wiki tab. Select the More options icon next to the tab and choose Remove. - Add a new wiki tab
Select the plus icon to add a new tab. Choose Wiki from the app list. Give the tab a name and create it. - Copy the content from the old notebook
Open the old notebook in OneNote online. Select all the pages you need and copy them. Paste the content into the new wiki tab.
Step 5: Update the Site URL in Teams (Alternative Method)
- Edit the wiki tab
In Teams, select the More options icon on the wiki tab and choose Settings. - Change the notebook URL
Look for a field that shows the notebook URL. Replace the old site URL with the new one. Save your changes. - Test the tab
Close the settings and click the tab again. The wiki content should load from the new URL.
If the Wiki Still Shows Missing Content After the Fix
Teams Still Shows a Blank Wiki Tab
If the tab remains blank after you update the URL, the Teams cache may still hold the old link. Clear the Teams cache by closing Teams completely and deleting the files in the %appdata%\Microsoft\Teams folder. Restart Teams and check the tab again.
The Notebook Is Not in the Teams Wiki Data Folder
If the folder is empty, the notebook may have been moved by a different process. Search the entire SharePoint site for files with the extension .one. Use the search box at the top of the site and type extension:one. If you find the notebook, move it back to the Teams Wiki Data folder.
The Rename Broke the Channel Link
In rare cases, the rename also changes the channel’s SharePoint folder. Check whether the channel folder still exists under the site’s document library. If the folder is missing, recreate the channel and then add the wiki tab again.
New Teams Desktop vs Teams on the Web: Key Differences
| Item | New Teams Desktop | Teams on the Web |
|---|---|---|
| Cache behavior | Stores cached URLs that may not refresh after a site rename | Uses the browser cache, which can be cleared more easily |
| Wiki tab loading | May show a blank page if the notebook URL is stale | Often loads the new URL automatically after a browser refresh |
| Recovery steps | Requires clearing the local Teams cache | Requires clearing the browser cache or using an incognito window |
Both versions use the same OneNote notebook, so the recovery steps are similar. The main difference is how you clear the cached URL.
You can now restore a Teams wiki after a SharePoint site rename by locating the notebook in SharePoint and either updating the tab URL or copying the content to a new tab. Before you rename a site in the future, consider disabling the Teams wiki tab and exporting the content to a regular OneNote notebook. As an advanced tip, use the SharePoint REST API to update the notebook link in the wiki tab configuration if you need to automate the fix for multiple teams.