Fix Hyperlink Not Working in Microsoft Teams

If hyperlinks in Microsoft Teams are not clickable or fail to open, the fix usually involves checking the link format, adjusting Teams settings, or clearing the Teams cache. This article walks you through the most effective solutions, from simple format checks to deeper troubleshooting steps.

Why Hyperlinks Fail in Teams

Hyperlinks in Teams can stop working for several reasons. The most common is that the link was pasted without the https:// prefix, which Teams sometimes fails to auto-detect. Other causes include a corrupted Teams cache, outdated app version, browser or OS-specific issues, or even a group policy that restricts external links. Understanding the root cause helps you apply the right fix quickly.

Check the Link Format First

Before diving into settings, verify that the link itself is properly formatted. In a chat or channel message, type or paste the full URL including https://. If you’re using the rich text editor, you can also highlight text and click the link icon to insert a URL manually.

Always include https:// or http:// – Teams may not recognize links without it.
Test the URL in a browser to ensure it’s not broken or blocked.
If the link contains spaces or special characters, use the link editor instead of pasting raw text.
For internal links (e.g., SharePoint or OneDrive), ensure you have permission to access the target.

Clear the Teams Cache

A corrupted cache is a frequent culprit for hyperlink issues. Teams stores temporary files that can become stale or damaged, preventing links from opening correctly. Clearing the cache is safe and often resolves multiple glitches.

Close Microsoft Teams completely (right-click the Teams icon in the system tray and select Quit).
Press Windows + R, type %appdata%\Microsoft\Teams, and press Enter.
Delete the contents of the following folders: Cache, Code Cache, GPUCache, Cookies, Local Storage, and tmp.
Restart Teams and test the hyperlink again.

On macOS, the path is ~/Library/Application Support/Microsoft/Teams. Be sure to back up any important files before deleting, though these folders are generally safe to remove.

Update Teams and Your Browser

Outdated software can have bugs that affect hyperlink handling. Teams updates automatically, but you can check manually by clicking your profile picture and selecting Check for updates. Similarly, if you’re using Teams in a web browser, ensure the browser is up to date. Sometimes, browser extensions (like ad blockers) interfere with link clicks; try disabling them temporarily.

Adjust Teams Settings

Teams has a setting that controls whether links open in the desktop app or in a browser. If links are not opening at all, this setting might be misconfigured.

In Teams, click your profile picture and select Settings.
Go to General and look for the File links or Link handling section.
Choose whether you want links to open in Teams or in your default browser. If you’re having issues, try switching the option and then switching it back.

Some users report that toggling the “Open links in desktop app” option resolves the issue. This setting is also available in the Teams admin center for IT admins, but individual users can change it in their own settings.

Repair or Reinstall Teams

If none of the above works, the Teams installation itself may be corrupted. You can repair the app from the Control Panel (Windows) or reinstall it entirely.

Windows: Go to Settings > Apps > Microsoft Teams, click Modify, and choose Repair.
macOS: Uninstall Teams (drag to Trash) and reinstall from the official Microsoft website.
After reinstalling, sign in again and test the hyperlink.

Check for Group Policies or IT Restrictions

In organizational environments, IT admins may set policies that block certain links or prevent hyperlinks from opening. If you’re on a work or school account, contact your IT support and ask if any policies affect link handling. They can check the Teams admin center under Messaging policies or App permission policies.

Frequently Asked Questions

Why do links work in the browser but not in the Teams desktop app?

This usually points to a cache issue or a problem with the desktop app’s integration with your default browser. Try clearing the cache (as described above) and ensure Teams is updated. If the issue persists, switch the link handling setting to open in browser, then back to the app.

How do I make a hyperlink clickable in a Teams chat?

Simply type or paste the full URL including https://. Teams automatically converts it into a clickable link. If you want custom text, use the link icon in the formatting toolbar to insert a display name and URL.

Why does clicking a link in Teams open a blank page?

A blank page often indicates that the link is blocked by a pop-up blocker or that the target site is down. Try opening the link in a different browser, or copy the link address (right-click > Copy link) and paste it into your browser manually.

Can a Teams administrator block hyperlinks?

Yes, admins can configure policies that restrict external links or disable hyperlink functionality entirely. If you suspect this, contact your IT department to verify your account’s permissions.

Does clearing Teams cache delete my chats?

No, clearing the cache only removes temporary files like images and stored data. Your chats, files, and messages are stored on Microsoft’s servers and remain intact.

Why do links work for some users but not others?

This often indicates a user-specific setting, cache issue, or device problem. Compare settings between a working and non-working user, and ensure both are on the same Teams version.

Preventing Future Hyperlink Issues

To minimize future problems, always use the full URL format, keep Teams and your browser updated, and periodically clear the Teams cache. If you frequently share links, consider using the Teams app’s built-in link editor to ensure proper formatting. For organizations, regular IT maintenance and clear user guidelines can reduce the frequency of these issues.

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →