How to Fix SharePoint Hero Web Part Links Not Working in Teams
Question details
Users are unable to click links within a SharePoint Hero web part when the page is embedded as a tab in Microsoft Teams.

- Product
- SharePoint Online / Microsoft Teams
- Device & OS
- not provided
- Scenario
- Accessing and interacting with a SharePoint page embedded as a tab inside a Microsoft Teams channel.
- Observed behavior
- Links in the Hero web part function normally in a standard web browser but become entirely unclickable in Teams. Right-clicking the panels also fails to display any link options.
Ensure you have editing permissions for the affected SharePoint site and have access to both the Microsoft Teams desktop client and the web version for testing.
Recreate the Hero Web Part on the SharePoint Page
If the existing web part has become corrupted and fails to pass URL configurations to Teams, rebuilding it from scratch will often restore normal link functionality.
Sometimes backend glitches prevent Teams from parsing embedded web part data correctly. Duplicating the page and generating a fresh web part ensures that all link mappings are clean and readable.
Navigate to your SharePoint site, open the page experiencing the issue, click on 'New' in the command bar, and select 'Copy of this page' to create a safe backup.
While in edit mode on the duplicated page, click the '+' icon on the canvas and select the 'Hero' web part to insert it above or below the broken one.
Edit the new Hero web part panels, manually paste your destination links into the URL fields, and upload your custom background images again.
Click on the old, malfunctioning Hero web part and select the trash can icon to delete it from the layout.
Click the 'Republish' button at the top right of the screen. Wait a few minutes, then check the Teams tab to see if the new links are clickable.

Isolate the Issue Between Teams Desktop and Web
Verify whether the link malfunction is specific to the local Teams desktop client or if it affects the broader Microsoft 365 environment.
Test on a New Communication Site
Determine if the problem is tied to custom front-end code on your specific site or if it is a tenant-wide bug requiring Microsoft Support intervention.
Looking for a Lightweight Document Collaboration Solution?
While dealing with complex integrations between SharePoint and Teams, you might want a simpler, more streamlined approach to daily office tasks. WPS Office is a highly compatible, fast, and free alternative that handles all your document, spreadsheet, and presentation needs without integration headaches.
- 1. Download the installer: Visit the official WPS Office website and download the free installation package for your operating system.
- 2. Install the software: Run the installer and follow the simple on-screen instructions to set up the suite on your device in minutes.
- 3. Open and collaborate: Launch WPS Office, open your existing Microsoft Office files with full compatibility, and start collaborating using WPS Cloud.

Frequently Asked Questions
Why do SharePoint Hero web part links work in a browser but not in Teams?
Microsoft Teams renders embedded SharePoint pages using an internal web viewer that sometimes fails to interpret specific web part scripts or deep links properly. This can cause interactive elements like Hero web part panels to display as static images instead of clickable hyperlinks.
Will clearing the Teams cache fix embedded SharePoint links?
If the links work correctly in Teams for the Web but fail in the Teams Desktop app, clearing the desktop cache may resolve the issue by forcing the client to pull a fresh, uncorrupted version of the embedded page.
How do I safely duplicate a SharePoint page to test fixes?
Navigate to the problematic page in SharePoint, click the 'New' button located in the top command bar, and select 'Copy of this page'. This creates an unpublished draft that you can freely edit without affecting the live version your team sees.




