Restrict @channel Mentions In Microsoft Team Messaging

Microsoft Teams is a communication product/service from Microsoft 365. It helps users to connect and communicate with other users in within internl and external organizations. There are two sets of user types within an Organization for a Team, Owners and Members.

By default, team members or owners can mention the @channel in chat messages. There is a setting available in Microsoft teams to block or allow the channel mentions.

In this post, I would like to show you how to restrict the users from mentioning the channel names in chat messages.

Team UI

  • Open Microsoft Team
  • If you are the owner of the Microsoft Team, Click the More Options (...) button for the particular Team
  • Click the Settings Tab
  • Expand the @mentions
  • Uncheck the option "Give members the option to @channel or @[channel name]. This will notify everyone who's shown the mentioned channel in their channel lists.​". Settings get automatically saved.

Microsoft Graph API

We can also use the Microsoft Graph API to do the same action. Use the below options in Microsoft Graph Explorer to block the same option.

Microsoft Graph API EndPoint

PATCH<team id>

Consent Permission

Delegated Permission: TeamSettings.ReadWrite.All, Group.ReadWrite.All**, Directory.ReadWrite.All**

The below request headers should be sent along with the request to update the settings,

Request Header

Content-Type: application/json

Request Body

    "messagingSettings": {
        "allowChannelMentions": false

In Microsoft Graph Explorer, click Run Query to send the request and update the settings for the Team.


Now the users won't be able to mention the channel in their messages in the Microsoft Team Chat. The below response will be returned after submitting the request.


Similar Articles