Others

How to Fix SharePoint Hero Web Part Links Not Working in Teams

Bushra ParveenBushra Parveen Oct 28, 2026 870 views

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.

How to Fix SharePoint Hero Web Part Links Not Working in 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.
Before you start

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.

Solution 1Recommended

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.

1
Duplicate the problematic page

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.

2
Insert a new Hero web part

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.

3
Reconfigure links and images

Edit the new Hero web part panels, manually paste your destination links into the URL fields, and upload your custom background images again.

4
Remove the original web part

Click on the old, malfunctioning Hero web part and select the trash can icon to delete it from the layout.

5
Republish the page

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.

Recreate the Hero Web Part on the SharePoint Page
Verification: Creating a clean instance of the web part forces Microsoft Teams to pull updated link pathways rather than relying on cached, potentially corrupted code.
Free Microsoft Office alternative

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. 1. Download the installer: Visit the official WPS Office website and download the free installation package for your operating system.
  2. 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. 3. Open and collaborate: Launch WPS Office, open your existing Microsoft Office files with full compatibility, and start collaborating using WPS Cloud.
Completely free and exceptionally lightweight office suiteFully compatible with Microsoft Word, Excel, and PowerPoint file formatsBuilt-in cloud storage for seamless document sharing and team collaborationFamiliar user interface ensuring zero learning curve during migration
microsoft office alternative - wps office

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.