Fix Teams App Tab Shows a Blank Page in a Shared Channel

When you open an app tab in a shared channel, Teams may show a blank white page instead of the app. This happens even though the same tab works fine in a regular team channel. The cause is usually a permission policy that blocks the app in shared channels, or a browser setting that prevents the embedded page from loading. This article explains why the blank page appears and gives you step-by-step fixes to restore the tab.

The blank tab issue affects both the desktop app and Teams on the web. It can also appear after a Teams update changes the default policy for shared channels. You will learn how to check your app permission policies, clear the Teams cache, and adjust browser settings that interfere with the embedded page.

Why a Teams App Tab Shows a Blank Page in a Shared Channel

A shared channel in Teams is a special type of channel that can include people from outside your organization. Because of this, Microsoft applies stricter security rules to apps in shared channels. The Teams app permission policy controls which apps are allowed to be added to a shared channel. If the policy does not include the app, Teams blocks the tab and shows a blank page.

Another common cause is the Teams cache. When you add a tab, Teams stores temporary files that help the app load quickly. If these files become corrupted or outdated, the tab may fail to render and appear blank. This often happens after a Teams update or when the app’s URL changes.

A third cause is the browser or Teams desktop environment blocking the embedded page. For example, if the app uses third-party cookies or pop-ups, the browser may block them, leaving the tab empty. This is more likely when you open the shared channel in Teams on the web.

How Teams Permission Policies Affect Shared Channel Tabs

Every app in Teams has a permission policy that defines where it can be used. The default global policy allows most apps in regular channels. But shared channels require the app to be explicitly allowed. If your tenant uses a custom policy that does not include the app, the tab will not load.

The policy setting that matters is called “Allow user app installation in shared channels.” When this is off, users cannot add any app tabs to a shared channel. When it is on, users can add apps that are also allowed by the app’s own settings. If the app is disabled at the tenant level, the tab will show a blank page even if the policy is on.

Steps to Fix the Blank Tab in a Shared Channel

Follow these steps in order. Start with the simplest fix and move to the advanced ones if the blank page persists.

1. Check the app permission policy in the Teams admin center
   Sign in to the Teams admin center at admin.teams.microsoft.com. Go to Teams apps > Permission policies. Select the policy that applies to the user who sees the blank tab. Scroll to the section “Microsoft apps” or “Third-party apps” and verify that the app is set to “Allowed.” If the app is not listed, click “Allow apps” and search for the app name. Save the policy and wait up to 24 hours for it to propagate.
2. Enable user installation in shared channels
   In the same permission policy, scroll to “Allow user app installation in shared channels.” Set it to “On.” This setting is off by default in some tenants. Save the policy and test the tab again.
3. Clear the Teams cache on the desktop app
   Close Teams completely. Press Ctrl+Shift+Delete to open the clear cache dialog in Teams. Select all cache types and click “Clear.” Restart Teams and open the shared channel. This removes corrupted temporary files that cause blank tabs.
4. Clear the browser cache in Teams on the web
   If you use Teams in a browser, open the browser settings and clear the cache and cookies. In Chrome, press Ctrl+Shift+Delete, choose “All time,” and click “Clear data.” In Edge, the shortcut is the same. Reload the Teams page and open the tab.
5. Allow third-party cookies in the browser
   Many Teams apps rely on cookies to load their content. In Chrome or Edge, go to Settings > Cookies and site data. Add the app’s domain to the allowed list. If you do not know the domain, check the app’s URL in the tab settings. This step is essential for Teams on the web.
6. Remove and re-add the tab
   In the shared channel, click the “+” icon next to the tabs. Find the app and select it. If the tab already exists, click the tab’s dropdown arrow and choose “Remove.” Then add the tab again. This forces Teams to reload the app with fresh settings.
7. Check the app’s own settings in the Teams admin center
   Go to Teams apps > Manage apps. Search for the app and open its details. Under “App settings,” confirm that “Allow installation in shared channels” is checked. If not, enable it and save. This applies to both Microsoft and third-party apps.

If You Are the IT Admin: Use PowerShell to Check Policy

Admins can verify the effective policy with PowerShell. Connect to Teams PowerShell and run the command Get-CsTeamsAppSetupPolicy. Look for the property AllowUserAppInstallationInSharedChannels. If it is False, set it to True with Set-CsTeamsAppSetupPolicy. This gives you a faster way to confirm the policy state.

If Teams Still Shows a Blank Tab After the Main Fix

Teams Shows a Blank Tab Only on the Web Version

If the tab works in the desktop app but not in the browser, the issue is usually browser-related. Check that the browser is up to date and that no extension blocks the app. Try opening the tab in an InPrivate or Incognito window. If it loads there, a browser extension is interfering. Disable extensions one by one to find the culprit.

Teams Shows a Blank Tab for One User Only

If only one user sees the blank page, the user’s Teams cache is likely corrupted. Have that user clear the cache as described in step 3. If the issue remains, check the user’s assigned permission policy. The user may have a custom policy that does not allow the app in shared channels.

Teams Shows a Blank Tab After an App Update

When an app updates, its URL may change. The old tab may point to a deprecated endpoint that returns a blank page. Remove the tab and add it again. If the app is a custom app, ask the developer to verify the new URL and update the app manifest.

Teams Desktop vs Teams on the Web: Blank Tab Differences

Item	Teams Desktop App	Teams on the Web
Cache location	Local user profile folder	Browser cache and cookies
Third-party cookie handling	Uses Teams’ own session	Depends on browser settings
Common fix	Clear Teams cache with Ctrl+Shift+Delete	Clear browser cache and allow cookies
Policy propagation time	Up to 24 hours	Up to 24 hours

The table shows that the desktop app handles cookies internally, while the web version relies on the browser. This is why browser settings matter more for Teams on the web.

Conclusion

You can now fix a blank app tab in a shared channel by checking permission policies, clearing the cache, and adjusting browser settings. Start with the simplest fix: clear the Teams cache with Ctrl+Shift+Delete. If that does not work, verify the app permission policy in the Teams admin center.

After applying the fixes, test the tab in both the desktop app and the web version. For recurring issues, use PowerShell to confirm the policy setting for shared channels. This advanced step gives you a quick way to audit multiple users at once.