This page documents features and processes maintained by Mastodon. For issues related to these features and/or processes, please reach out to the Mastodon team directly on the Mastodon project’s GitHub.
For issues with this doc page itself, please reach out to us on Hachyderm’s Community Issue tracker.
What are content warnings?
Content warnings are a feature that allows you to obscure your content in such a way that it is hidden by default in other users’ timelines. Instead, only the text of the content warning is displayed. To put it another way, if you were to put a content warning on one of your posts that read “descriptions of war violence” while discussing current or past wars, users would only see that description and could then choose to click through the content warning to view the content (or not).
How to apply a content warning
In order to apply a content warning use the “CW” in the post field:
An example post with a content warning on the text and image looks like this:
Threads with a content warning
Whenever someone replies to a post with a content warning, by default their response will carry the same content warning. Here is an example:
This is the default due to the nature of the content warning: if the top-most post of a thread needs a content warning due to what’s being shown or discussed, then the rest of that thread probably needs the same content warning. This is true both for when you respond to your own posts or when other users respond to your posts.
When you reply to a post with a content warning you can manually disable and delete the content warning, but please do so with care. When you remove the content warning from your post all replies to you will also no longer be behind a content warning by default, even if they should be.
When are content warnings used
Content warnings are generally used to either hide spoilers or to provide a buffer when it is psychologically safer to choose to opt in to a conversation as opposed to being opted in by default (seeing it in a timeline). For more information on the nuance for how and when to use content warnings, please take a look at our doc on how to use content warnings.