When you try to mention more than a few Mastodon users in a single post, the server may block the message or hide it from public timelines. Mastodon instances enforce spam filters to prevent mass unsolicited notifications, and mentioning many accounts at once is a common trigger. This article explains how the mention-based spam filter works and how to mention up to ten users safely without being flagged.
Key Takeaways: Keeping Mastodon Mentions Under the Spam Threshold
- Preferences > Appearance > Post visibility: Switch to Unlisted or Followers-only to avoid public timeline checks that flag mass mentions.
- Content warning field: Wrap the post in a content warning to bypass some server-side spam heuristics that scan the main body text.
- Timing between posts: Wait at least 15 minutes between posts that contain multiple mentions to avoid rate-limit triggers.
Why Mastodon Blocks Posts With Many Mentions
Mastodon servers use spam detection rules that look for patterns resembling automated broadcasting. A post that includes @-mentions for more than three to five distinct accounts in one message is often treated as unsolicited or promotional content. The server may reject the post outright, hide it from public timelines, or prevent it from being delivered to the mentioned users.
The exact threshold varies by instance. Some servers set the limit at four mentions per post, while others allow up to ten before triggering a warning. The filter checks the total number of unique @-mentions in the post body, including replies and reblogs. If the count exceeds the instance-defined maximum, the server returns an error or silently drops the post from federated timelines.
How the Spam Filter Scans Mentions
The spam filter runs on the server side after you click Publish. It counts all @-mentions that appear in the status text, excluding the author’s own handle. The filter does not distinguish between replies to an existing thread and original posts. It also ignores mentions embedded inside content warnings because the warning text is not parsed the same way as the main body. Some instances apply a secondary rate limit: if you send multiple posts with high mention counts within a short time, the server may temporarily mute your account from posting.
Steps to Mention Up to Ten Users Safely
Follow these steps to mention multiple accounts without triggering the spam filter. The method works on Mastodon web, official mobile apps, and third-party clients.
- Open the compose box and write your message
Type the main content of your post as you normally would. Do not add any mentions yet. Keep the message concise to avoid additional server-side scanning. - Add a content warning
Click the CW icon (usually a warning triangle or the text “CW”) above the compose box. Enter a short description such as “Group reply” or “Team update.” The content warning field hides your main text behind a clickable warning. Mastodon’s spam filter applies looser rules to posts with content warnings, reducing the chance of a block. - Type the @-mentions inside the content warning field
Place all ten mentions inside the content warning text box rather than in the main body. For example, write “@user1 @user2 @user3 @user4 @user5 @user6 @user7 @user8 @user9 @user10” in the CW field. The post body itself can remain empty or contain a short note. The spam filter checks the main body first and the CW field second, so separating mentions lowers the risk. - Change post visibility to Unlisted or Followers-only
Click the visibility icon (globe, lock, or people icon) and select Unlisted or Followers-only. Public posts face the strictest spam checks because they appear on the federated timeline. Unlisted posts skip public timeline scanning, and Followers-only posts are only visible to people who already follow you. Both options bypass the most aggressive spam filters. - Publish the post
Click Publish. The post will appear on your profile and in the home feeds of your followers. The mentioned users receive a notification, but the post does not appear on the public or federated timeline. If the server still rejects the post, reduce the number of mentions to eight and try again.
Alternative Method: Split Mentions Across Multiple Posts
If you need to mention more than ten users, split the mentions across two or more posts. Wait at least 15 minutes between each post to avoid the server’s rate limit. Use the same content warning and Unlisted visibility for each post. This method avoids the mention count threshold entirely because each post stays under the limit.
Common Mistakes and How to Avoid Them
Post Still Rejected After Using a Content Warning
Some instance administrators set the spam filter to scan both the content warning field and the main body. If your post is still rejected, reduce the number of mentions to five and try again. You can also ask your instance admin to raise the mention limit for your account if you regularly need to mention many users.
Mentioned Users Do Not Receive Notifications
When you place mentions inside the content warning field, some Mastodon clients do not generate notifications for those users. To ensure notifications are sent, keep at least one mention in the main body and the rest in the CW field. For example, write “@user1” in the main body and the other nine mentions in the CW field.
Account Temporarily Muted From Posting
If you publish multiple posts with high mention counts quickly, the server may impose a temporary mute that lasts 30 to 60 minutes. Wait for the mute to expire, then reduce your posting frequency. Space out posts with mentions by at least 15 minutes.
Mastodon Post Visibility Options for Mention-Heavy Posts
| Item | Public | Unlisted | Followers-only |
|---|---|---|---|
| Spam filter strictness | Highest | Moderate | Lowest |
| Appears in federated timeline | Yes | No | No |
| Appears in local timeline | Yes | No | No |
| Visible to non-followers | Yes | Yes, via profile or direct link | No |
| Notification to mentioned users | Yes | Yes | Yes |
Using Unlisted or Followers-only visibility for posts with multiple mentions is the most reliable way to avoid spam filter blocks while still reaching the intended audience.
You can now mention up to ten Mastodon users in a single post without triggering the spam filter by combining a content warning with Unlisted or Followers-only visibility. If the server still blocks the post, reduce the mention count to five and try again. For advanced use, ask your instance admin to check the server’s max_mentions_per_status setting in the Mastodon configuration file — raising that value to 15 allows more mentions per post without filtering.