Mastodon allows you to hide the body of a post behind a content warning label. This feature is often called CW or content warning. It helps you share sensitive or spoiler material without forcing others to see it immediately. This article explains how to add content warnings to your posts and how to use them correctly for different situations.
Key Takeaways: Using Mastodon Content Warnings Correctly
- Post composer CW toggle: Click the CW icon (eye with a slash) to enable the content warning field before writing your post.
- CW label text: Write a short, clear label that describes what is hidden such as “spoiler for episode 5” or “discussion of medical procedures”.
- Mastodon mobile app CW: Tap the three dots or the pencil icon to access the content warning field on iOS and Android.
Understanding the Mastodon Content Warning Feature
The content warning field is a text box that appears above the main post body when you enable it. You enter a short label and the main text becomes hidden behind a clickable warning. Other users see only the label and must click to reveal the full content. This feature is built into Mastodon’s web interface and official mobile apps.
No special permissions or server settings are required to use content warnings. Every Mastodon account can add them to any post. The feature is part of the Mastodon core software and works across all instances.
Content warnings serve two main purposes. First, they hide sensitive topics such as violence, nudity, or medical content. Second, they hide spoilers for movies, TV shows, books, or games. Using content warnings is considered good etiquette in the Mastodon community.
Steps to Add a Content Warning to a Mastodon Post
- Open the post composer
Click the compose button in the Mastodon web interface or tap the compose icon in the mobile app. The text area appears with formatting options above it. - Enable the content warning field
Click the CW icon on the formatting toolbar. On the web, it looks like an eye with a diagonal line through it. On mobile, tap the three dots menu and select “Content warning”. The CW field appears above the main text box. - Write the content warning label
Type a short description of the hidden content. Use clear language such as “political discussion”, “graphic description of injury”, or “spoiler for season finale”. Keep the label under 80 characters so it fits on screen. - Write the post body
Type your full message in the main text area below the CW label. The post body can include text, images, links, and mentions. Images also remain hidden until the warning is clicked. - Post or schedule the message
Click “Publish” or “Schedule” as you normally would. The post appears in your followers’ timelines with the CW label visible. Other users must click the label to read the full content.
Common Mistakes and Things to Avoid With Content Warnings
Writing a vague or useless CW label
A label like “CW” or “warning” does not help readers decide whether to click. Always write a specific label such as “discussion of anxiety triggers” or “spoiler for book chapter 7”. A good label lets people make an informed choice.
Using a content warning for non-sensitive content
Some users hide ordinary posts behind a CW as a joke or to increase engagement. This frustrates followers because they must click to see content that is not sensitive. Reserve content warnings for topics that genuinely need them.
Forgetting to add a CW for images
If you attach an image that contains sensitive material, the CW hides both the text and the image. However, the image’s alt text is still visible to screen readers. Ensure the alt text is appropriate and does not reveal sensitive details.
Not using a CW for long threads
Long threads that discuss sensitive topics should also use a CW. The CW applies to the first post only. Readers who click the warning see the entire thread. If you post multiple replies without a CW, followers see each reply individually in their timeline.
Content Warning vs No Content Warning: Comparison
| Item | With Content Warning | Without Content Warning |
|---|---|---|
| Post visibility in timeline | Only the CW label is visible | Full text and images are visible |
| Reader control | Reader chooses to view or skip | Reader sees everything immediately |
| Best use case | Sensitive topics, spoilers, triggers | Everyday conversation, news, humor |
| Impact on engagement | May reduce accidental exposure | Higher chance of unwanted viewing |
The content warning field is a simple but powerful tool for respectful communication on Mastodon. Adding a clear label protects your followers from unwanted content and shows that you understand community norms. Use the CW icon every time you post about sensitive material. This small step makes Mastodon a safer space for everyone.
After you master the basic CW feature, try combining it with Mastodon’s image description field. Describe the image in the alt text field and use the CW to hide the image itself. This gives visually impaired users full context while protecting others from sensitive visuals.
If you manage a Mastodon instance, consider writing a server rule about content warnings. Many instances include a rule that requires CWs for political content or graphic media. A clear rule helps new users learn the feature quickly.