sodcalculator

10 Tech How-To

Hyperlink Not Working in Microsoft Teams? Fix It Here

Guide 10-8081 · Updated · Step by step

If hyperlinks are not working in Microsoft Teams, the issue is usually caused by the Teams desktop app intercepting clicks, a broken link format, or a company policy that blocks certain URLs. The fix is to try opening the link in your default browser, check the link’s formatting, and clear the Teams cache if the problem persists. Below is a step-by-step guide to diagnose and resolve the most common causes.

Why Hyperlinks Stop Working in Teams

Microsoft Teams renders links in chat messages, channels, and tabs as clickable text. When a link fails, it’s often because the app’s built-in browser (WebView2) is not handling the redirect correctly, or because the URL itself has been pasted with extra characters (like a trailing period or a space) that break the hyperlink. Another common cause is an organization’s security policy that restricts which domains can be opened from within Teams. In some cases, the Teams client is outdated, and a known bug was fixed in a later update.

Quick Fixes to Try First

Before diving into deeper troubleshooting, try these three quick actions. They resolve a large percentage of link issues:

  • Press Ctrl + Click (Windows) or Cmd + Click (Mac) – This forces Teams to open the link in your default browser instead of the internal browser.
  • Copy the link and paste it into a new browser tab – Right-click the link, select “Copy link,” then paste it into Edge, Chrome, or Firefox. If it opens there, the problem is with Teams’ internal browser.
  • Restart Teams – Fully quit the app (right-click the Teams icon in the system tray and select “Quit”) and reopen it. This clears temporary glitches.

If none of these work, move on to the more detailed solutions below.

Check the Link Format and URL

A hyperlink in Teams must be a valid URL. If you typed or pasted a link that is missing the protocol (e.g., you wrote www.example.com without https://), Teams may not recognize it as clickable. Always ensure the link starts with https:// or http://. Also, watch for extra punctuation that gets included in the link, such as a period at the end of a sentence. For example, https://example.com. (with a trailing dot) will fail. If you are pasting from a document, the link may include hidden formatting characters—paste into Notepad first to strip formatting, then copy from there.

Clear the Teams Cache

A corrupted cache is a frequent culprit for broken links and other UI glitches. Clearing the cache does not delete your chats or files, but it will reset some local settings. Here’s how to do it on Windows:

  1. Close Microsoft Teams completely (right-click the tray icon and select “Quit”).
  2. Press Win + R to open the Run dialog.
  3. Type %appdata%\Microsoft\Teams and press Enter.
  4. In the folder that opens, delete the contents of these subfolders (if they exist): Cache, Code Cache, GPUCache, and blob_storage.
  5. Restart Teams. It will rebuild the cache.

On a Mac, the path is ~/Library/Application Support/Microsoft/Teams – delete the same subfolders. Note that this is a safe operation, but if you are unsure, you can rename the folders instead of deleting them (e.g., Cache_old) to test.

Update Teams or Reinstall the App

Microsoft releases updates regularly, and some contain fixes for link-handling bugs. To update Teams manually, click your profile picture in the top-right, then select “Check for updates.” If you are already on the latest version, consider reinstalling the app. Uninstall Teams from your computer (via Settings > Apps), then download the latest version from the official Microsoft website. Your chats and channels are stored in the cloud, so you won’t lose any data. After reinstalling, sign in and test the link again.

When the Problem Is with a Specific Link

If only one particular link fails, but others work, the issue is likely with that URL. Possible reasons:

  • The website is down or blocking Teams’ user agent.
  • The link contains a redirect that the internal browser cannot follow.
  • The link points to a file that requires a specific app to open (e.g., a local file path like C:\folder\file.pdf – these are not supported in Teams chat).

For internal SharePoint or OneDrive links, make sure you have permission to access the file. If you are trying to open a link that requires a VPN, connect to the VPN first, then try again.

Company Policies and Admin Settings

In some organizations, IT administrators set policies that restrict which external links can be opened from Teams. This is done to prevent phishing or data leakage. If you suspect this is the case, contact your IT support and ask if there is a policy blocking certain domains. They can also check the Teams admin center under “Messaging policies” to see if “Link previews” are disabled, which can affect how links behave. You cannot change these settings yourself.

Frequently Asked Questions

Why do links open in Teams’ internal browser instead of my default browser?

Teams uses an embedded browser for convenience. To change this, go to Teams Settings > General and look for “Open links in desktop browser” – enable that option. If you don’t see it, your admin may have disabled it.

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

Simply type or paste the full URL starting with https://. Teams automatically converts it to a clickable link. If you want to display custom text, use the [text](url) format in a message (Markdown) – for example: [Microsoft](https://www.microsoft.com).

Why does a link work in a browser but not in Teams?

This usually points to Teams’ internal browser failing to render the page, often due to a security certificate error or a redirect that the embedded browser blocks. Try opening the link in your default browser using the Ctrl+Click method, or copy the link and paste it into a browser tab.

Can I open a local file path as a hyperlink in Teams?

No. Teams does not support file:// links for security reasons. Instead, upload the file to a SharePoint or OneDrive location and share the link to that file.

Why does the link show as plain text and not become clickable?

This happens when the URL is not recognized as a valid link, often because it lacks https:// or contains spaces. Re-type the URL with the protocol and no spaces. If you pasted from a rich source, the formatting may interfere – paste as plain text (Ctrl+Shift+V).

What should I do if the link works for others but not for me?

This suggests a local issue on your device, such as an outdated Teams version, a corrupted cache, or a browser default setting. Try the cache clearing steps and update Teams. If the problem persists, check if your account has specific permissions to access the link’s destination.

If none of these solutions resolve the issue, the problem may be a temporary server-side issue with Microsoft Teams. You can check the Microsoft 365 Service Health dashboard to see if there is an ongoing incident. In most cases, however, the steps above will get your hyperlinks working again.

Related

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 →