How to Block a Specific Hashtag From Your Mastodon Timeline

Your Mastodon home timeline can become cluttered with posts about topics you do not want to see. A single trending hashtag can dominate your feed with dozens of posts you have no interest in. Mastodon provides a built-in feature to mute a hashtag so that posts using it no longer appear in your timeline or notifications. This article explains how to block a specific hashtag using the web interface and mobile apps, and covers what happens to your timeline after you mute a tag.

How Mastodon Hashtag Muting Works

Mastodon treats hashtag muting as a content filter applied to your Home timeline, Local timeline, and notifications. When you mute a hashtag, Mastodon hides any post that contains that exact hashtag. The post is not deleted or reported. It is simply hidden from your view. The author of the post does not know you muted the tag.

Mastodon supports two methods for muting a hashtag. The first is a quick mute from the hashtag context menu on a post. The second is a permanent filter created in your account settings. Both methods achieve the same result, but the filter method gives you more control over expiration and scope.

A muted hashtag applies only to your account. Your decision does not affect other users on your instance. You can unmute a hashtag at any time from your account settings.

What a Hashtag Mute Does Not Do

A hashtag mute does not remove posts from the Federated timeline. The Federated timeline shows all public posts from instances your server knows about. Mastodon does not apply content filters to the Federated timeline by design. If you want to block a hashtag everywhere including search results, you must create a custom filter with the Search and Public timeline scopes selected.

A hashtag mute also does not prevent you from manually searching for that hashtag. If you search for the muted tag, you will still see results. The mute only affects automatic display in your timelines and notifications.

Steps to Block a Hashtag From Your Mastodon Timeline

Follow these steps to mute a hashtag using the Mastodon web interface. The same steps apply to the official Mastodon mobile apps for iOS and Android with minor layout differences.

Method 1: Mute a Hashtag From a Post in Your Timeline

1. Locate a post containing the hashtag you want to block
   Scroll through your Home or Local timeline until you see a post that uses the unwanted hashtag.
2. Open the post context menu
   Click the three-dot icon at the top right of the post. On mobile, tap the three-dot icon below the post.
3. Select the hashtag from the menu
   A submenu appears showing each hashtag used in the post. Click the hashtag you want to mute. A new menu appears with options for that hashtag.
4. Click Mute
   In the hashtag menu, click Mute. Mastodon immediately hides all posts containing that hashtag from your Home timeline, Local timeline, and notifications.

You do not need to refresh the page. The posts that were already visible disappear within a few seconds.

Method 2: Add a Hashtag Filter in Account Settings

1. Open your account settings
   Click the gear icon in the Mastodon web interface. On mobile, tap your profile avatar and select Preferences.
2. Navigate to Filters
   In the left sidebar, click Filters. This page lists all your active filters.
3. Click Add new filter
   A form opens with fields for the filter keyword, expiration, and scope.
4. Enter the hashtag as the filter keyword
   Type the hashtag without the # symbol. For example, type spam to block the hashtag #spam. Mastodon treats the keyword as a case-insensitive match.
5. Set the expiration date (optional)
   If you want the mute to expire after a specific date, select a date in the expiration field. Leave it blank for a permanent mute.
6. Select the filter scope
   Check the boxes for Home, Notifications, and Public conversations to block the hashtag from your main views. To also block it from the Federated timeline and search, check Public timeline and Search.
7. Click Save
   Mastodon applies the filter immediately. Posts matching the hashtag disappear from the selected timelines.

Method 3: Mute a Hashtag From Its Dedicated Page

1. Navigate to the hashtag page
   Click any hashtag link in a post or search for the hashtag. The hashtag page shows all public posts using that tag.
2. Click the three-dot menu on the hashtag page
   On the hashtag page header, click the three-dot icon next to the hashtag name.
3. Select Mute
   Click Mute from the dropdown menu. Mastodon applies the mute immediately.

Common Issues When Blocking Hashtags in Mastodon

Hashtag Mute Does Not Remove Posts From the Federated Timeline

This is by design. Mastodon does not apply content filters to the Federated timeline. To block a hashtag from the Federated timeline, create a filter using Method 2 and check the Public timeline scope. This hides the posts from the Federated timeline view.

Posts With the Hashtag Still Appear in Search Results

A mute from the context menu or hashtag page only affects your Home timeline, Local timeline, and notifications. To block the hashtag from search results, create a filter and check the Search scope. Mastodon will then hide those posts from your search results.

Muted Hashtag Still Shows in Lists or Bookmarks

Mastodon filters do not apply to Lists or Bookmarks. If you use a List to view posts from specific accounts, posts with the muted hashtag may still appear. There is no way to apply a hashtag mute to a List in Mastodon as of version 4.3.

You Accidentally Muted the Wrong Hashtag

To unmute a hashtag, go to Preferences > Filters. Find the filter you created for that hashtag and click Delete. If you used the quick mute from the context menu, go to Preferences > Muted hashtags and click the Unmute button next to the hashtag.

Item	Quick Mute (Context Menu)	Filter (Preferences)
Setup time	Instant, 2 clicks	30 seconds, 7 fields
Scope	Home, Local, Notifications	Home, Local, Notifications, Public timeline, Search
Expiration	Permanent only	Custom date or permanent
Unmute method	Preferences > Muted hashtags	Preferences > Filters
Multiple hashtags	One per mute action	One keyword per filter; create multiple filters

Blocking a hashtag in Mastodon is a straightforward process that keeps your timeline focused on the topics you care about. Use the quick mute for temporary cleanup during a trending event. Use the filter method when you need to block a hashtag from the Federated timeline or search results. You can manage all your muted hashtags from the Filters page in your account settings at any time.