When you paste a legitimate link into a Teams private channel, Safe Links may intercept it and show a warning page instead of opening the destination. This happens because Microsoft 365 Defender checks every URL against threat intelligence and tenant policies before allowing access. The warning can appear even for trusted internal addresses or public sites that are clearly safe. This article explains why Safe Links flags valid URLs and walks you through the settings to unblock them without weakening security.
Key Takeaways: Unblocking Safe Links in Teams Private Channels
- Microsoft 365 Defender portal > Policies > Threat policies > Safe Links: Location where you create or edit a policy that applies to Teams.
- Safe Links policy > URL & click protection settings > Do not rewrite URLs: Option that lets you list trusted domains and avoid the warning page.
- Teams admin center > Teams apps > Permission policies: Setting that controls whether users can install custom apps that may bypass link checking.
Why Safe Links Blocks Valid URLs in Private Channels
Safe Links is part of Microsoft Defender for Office 365. It scans URLs in emails and Teams messages at the time of the click. When a user clicks a link, Teams sends the URL to Microsoft’s threat intelligence service. The service checks the domain, path, and reputation. If the URL is not on an allowlist or if the domain has a low reputation score, Safe Links shows a warning page instead of the real site.
Private channels in Teams use a separate SharePoint site for file storage and permissions. Links that point to files, folders, or pages inside that SharePoint site are often flagged because the URL contains a long tenant-specific path. The path includes the tenant name, the site collection ID, and the channel folder structure. This complex URL can look suspicious to automated scanners, especially if the domain is not on the default allowlist.
Default Safe Links Behavior in Teams
By default, Safe Links policies apply to Teams messages. The default policy is called “Default (Office 365)”. It rewrites URLs and shows the warning interstitial page. The page gives the user two choices: continue to the site or go back. Many users see this as a block, but it is technically a warning that can be bypassed manually.
The warning appears more often in private channels because those messages are stored in a different message container than regular channel messages. The URL scanning pipeline treats them the same, but the SharePoint URLs are longer and include query parameters that increase the chance of a false positive.
Steps to Allow a Valid URL in Safe Links for Teams
You must be a global administrator or a security administrator in Microsoft 365 to change Safe Links settings. The steps below use the Microsoft 365 Defender portal.
- Open the Safe Links policy area
Go to Microsoft 365 Defender portal at security.microsoft.com and sign in. In the left navigation, select Policies & rules then Threat policies. Under Policies, click Safe Links. - Create a new policy or edit an existing one
Click + Create to make a new policy. Name it something clear like “Teams Allowlist for Private Channels”. If you already have a policy that applies to Teams, click its name to edit it. - Set the user and domain scope
On the Users and domains page, specify the users or groups that should get this policy. For a tenant-wide fix, select All users. Then add the domain of the blocked URL in the Domains field. For example, if the blocked link is https://contoso.sharepoint.com, add contoso.sharepoint.com. - Configure URL and click protection
On the URL & click protection page, turn on Do not rewrite URLs. This option stops Safe Links from rewriting the URL and showing the warning page. Leave Track user clicks enabled so you still get reporting data. - Add the URL to the allowlist
Scroll to Do not rewrite the following URLs and click + Add. Enter the exact URL that was blocked. You can add up to 50 entries. Use the form https://contoso.sharepoint.com/sites/PrivateChannelName to allow a specific channel folder. - Save and test the policy
Click Next through the remaining pages, then click Create or Save. Wait 15 to 30 minutes for the policy to propagate. Then click the link in the private channel again. The warning page should no longer appear.
Alternative Method: Use the Built-In URL Allowlist
If you do not want to create a full Safe Links policy, you can use the tenant allowlist in Defender. Go to Microsoft 365 Defender portal > Policies & rules > Threat policies > Tenant Allow/Block Lists. Click + Add and choose URLs. Enter the blocked URL and set the action to Allow. This method applies to all users and all workloads, including Teams, email, and Office apps.
What to Do If the Warning Still Appears
If the warning persists after you add the URL to the allowlist, check the following:
- Confirm the exact URL
Right-click the link in Teams and copy the address. Compare it to what you added in the allowlist. The path may include extra query parameters. Add the full URL including the query string, or use a wildcard pattern like https://contoso.sharepoint.com/sites/PrivateChannelName/ if your tenant allows wildcards. - Check for conflicting policies
Safe Links uses the most restrictive policy. If you have multiple policies, the one with the highest priority wins. Verify that your new policy has a lower priority number than the default policy. In the Safe Links list, policies are ordered from top to bottom. Drag your policy to the top or set its priority to 0. - Clear the Teams cache
Teams may cache the warning page. Close Teams completely, then delete the cache folder at %appdata%\Microsoft\Teams. Restart Teams and try the link again.
If Teams Still Blocks the URL After the Policy Change
Teams Shows “This URL has been blocked by your administrator”
This message appears when the URL is on the tenant block list. Go to Tenant Allow/Block Lists and remove the entry. If you did not block it manually, check with your security team. Sometimes a global block list from Microsoft includes the domain. In that case, you cannot override it. Submit a support request to Microsoft to review the block.
Safe Links Warning Appears Only on Mobile Devices
The mobile Teams app uses a different URL scanning pipeline. The allowlist you set in the Defender portal applies, but the mobile app may cache the warning. Force-close the app and reopen it. If the issue continues, update the app to the latest version from the App Store or Google Play.
Links in Private Channel Files Show a Warning, But Regular Channel Links Work
Private channels use a separate SharePoint site. The URL contains a unique site ID that is not present in regular channel links. Add the full SharePoint site URL to the allowlist. To find the exact URL, open the Files tab in the private channel, right-click a document, and select Copy link. Use that full URL in the allowlist.
Safe Links Policy for Teams vs Email: Key Differences
| Item | Safe Links Policy for Teams | Safe Links Policy for Email |
|---|---|---|
| Scope | Applies to links in Teams messages and files | Applies to links in Outlook email messages |
| URL rewriting | Can be disabled per policy | Can be disabled per policy |
| Allowlist location | Same tenant allow/block list | Same tenant allow/block list |
| Warning page | Shows a Teams-specific interstitial | Shows an Outlook-specific interstitial |
| Policy priority | Uses highest priority policy | Uses highest priority policy |
You can now allow a valid URL in a private channel by editing the Safe Links policy or using the tenant allowlist. Start with the tenant allowlist because it is simpler and applies everywhere. After you make the change, test the link in both the desktop and mobile Teams apps. For a long-term fix, review your Safe Links policies and add your internal SharePoint domains to the default allowlist so future links are not blocked.