Short answer: Mastodon calls muted words "filters". On Mastodon's website, go to Preferences > Filters and click Add new filter. Give it the words or phrases to match, choose where it applies, and choose whether matching posts are hidden behind a warning or hidden completely.

Filters are saved on your server, so a filter you make on the web works in every app signed in to your account.

The Quick Answer

QuestionAnswer
Where are they?Preferences > Filters on the web
What gets matched?Post text, content warnings, media descriptions and poll options
Can I match whole words only?Yes, per keyword
Can a filter expire?Yes, or never
Do they work in every app?Yes, they're saved on your server

How to Create a Filter on Mastodon's Website

  1. Open Preferences, then Filters.
  2. Click Add new filter and give it a title, like "World Cup spoilers".
  3. Add one or more keywords or phrases. Turn on whole word for short words, so "cat" doesn't hide "category".
  4. Choose where it applies: Home timeline and lists, Notifications, Public timelines, Conversations and Profiles.
  5. Choose the action: hide matching posts with a warning you can click through, or hide them completely.
  6. Optionally set it to expire, then save.

Warning or Hide Completely?

  • Hide with a warning collapses the post and tells you which filter it matched, so you can still open it. Good for spoilers.
  • Hide completely removes matching posts, and Mastodon's docs say they "will never be delivered to your home or notifications." Good for topics you never want to see.
  • Newer servers (Mastodon 4.4 and later) can also hide just the media on a matching post behind a warning.

Tips for Filters That Work

  • Add the hashtag and the word. A filter on "election" and "#election" catches both.
  • Use expiry for events. A one-week filter for a finale or a match day cleans itself up. Expired filters aren't deleted, so you can switch one back on next season.
  • Filters match media descriptions too, so a filtered word in someone's alt text will hide the post.
  • Muting a person is a different tool. See how to mute or block someone on Mastodon.

When Skyscraper Is the Better Way

Many Mastodon apps only respect filters you made on the web. Skyscraper lets you create and edit them right in the app: go to Settings > Settings for @you > Filters and tap New Filter. You get the same choices as the website, in plain words: a Title, Keywords with a Whole word switch each, Filter in (Home and lists, Notifications, Public timelines, Conversations, Profiles), an Action (Hide behind a warning, Hide completely, or Hide media behind a warning) and Expires. Tap Create Filter and your timeline refreshes with it applied.

Because Skyscraper saves the filter to your server, it works on the web and in other apps too. That's the better way if you mostly use Mastodon on your phone and don't want to open a browser to mute a spoiler.

Frequently Asked Questions

Can you mute words on Mastodon?

Yes. Mastodon calls them filters. Create one in Preferences > Filters on the web, or in Skyscraper under Settings > Filters.

What does a Mastodon filter match?

Post text, content warnings, media descriptions and poll options.

What's the difference between hiding with a warning and hiding completely?

A warning collapses the post and lets you open it. Hide completely removes it so you never see it.

Do Mastodon filters work in apps?

They're saved on your server, so any app that applies Mastodon's filters will use them.

Can I set a filter to expire?

Yes. Choose an expiry when you make it. Expired filters stay in your list so you can turn them back on.

Filters in Skyscraper

Filters, along with Muted Accounts, Blocked Accounts and Blocked Domains, are free in Skyscraper for your Mastodon account. Skyscraper is free to download, and your one free account can be Bluesky or Mastodon. A second account, and features marked Pro, are part of Skyscraper Pro.

Get Skyscraper on the App Store

Blog readers get a deal: as a bonus for reading the blog, use promo code BLOG or this special link to get your first year of Skyscraper for $5.99 USD (or your local equivalent).

Related Reading