Profile, Bio & Content Warnings

What a Mastodon profile should signal, the content warning convention, and the local vs federated context.

Jump to module

Banner

Lesson 1: Profile Elements That Matter

Mastodon profiles are simpler than other platforms but the simple elements are read carefully.

The display name

Your display name is what shows in feeds, not your handle. Use your real name (or your brand name, if that's how you'll be known).

Display name conventions:

  • Short.
  • Often includes pronouns at the end: "Max Fritzhand (he/him)".
  • Sometimes includes occupation: "Max — Founder, Bolta".
  • Avoid emoji walls.

The handle

Your @handle@instance address. This is the unique identifier.

  • Pick a handle you can live with. Hard to change.
  • Keep it short and readable.
  • Match it to your handles on other platforms when possible.

The bio

500 characters. Use them deliberately.

A strong Mastodon bio:

  1. What you do in one line.
  2. What you'll post about in one line.
  3. Where else you exist (links to other socials, website, etc.).

Optional: hashtags in the bio. Mastodon parses these. Including #indiehackers #ai #buildinpublic in your bio means you show up in those hashtag searches as a profile to follow.

The header image

A simple banner. Less critical than other platforms — Mastodon profiles are often viewed as small cards. Don't sweat it.

The "verified" trick

Mastodon doesn't have blue checkmarks. But you can verify ownership of your website by adding a specific link to your site that points back to your Mastodon profile. Done correctly, your bio shows a green checkmark next to the link.

This is the closest Mastodon gets to verification. Set it up — it's a small but visible signal of "I'm not impersonating anyone."

The pinned posts

You can pin up to 5 posts. Use them like a portfolio:

  1. Best post you've written.
  2. Pinned thread (if you've done one).
  3. Pinned link to your strongest off-platform asset.
  4. An "about me" post if it adds context.

Lesson 2: The Content Warning Convention

Content warnings (CW) are the single most distinctive cultural convention on Mastodon. Use them right and you fit in. Skip them and you stick out.

What CW does technically

A post with a content warning shows only the warning text by default. Readers tap to expand and see the actual post. Their choice to read or skip.

What CW does culturally

It's a way of saying "this might not be for everyone." A few common uses:

  1. Politics — anything political gets a CW so people who want a politics-free timeline can skip.
  2. Food — sometimes used (helpful for people with eating disorders or fasting).
  3. Long posts — long-form content sometimes gets a CW so it doesn't dominate feeds.
  4. Mental health — content about anxiety, depression, etc.
  5. News / breaking events — to spare people who don't want to be hit with news while scrolling.
  6. Off-topic personal content — when posting outside your usual niche.

What NOT to put behind CW

  1. Your normal content. Don't CW everything; defeats the purpose.
  2. Marketing or promotional content. That's spam, not a content warning.
  3. Sensitive content as a tease. "Click to see something interesting!" reads as clickbait.

The CW convention itself

The warning text should be specific:

  • Bad: "stuff."
  • Good: "us politics."
  • Bad: "rant."
  • Good: "long post about freelance pricing."

Specific CWs let people make real decisions about what to read.

When in doubt

If you're unsure whether to CW something, lean toward yes. It's a small courtesy that the audience appreciates. Frequent users on Mastodon often default to CW for anything that isn't "safe for everyone."

Lesson 3: Local vs Federated Context

Your posts appear in different places. Understanding where helps you write for the right audience.

Where your posts go

By default, every post you make appears in:

  1. Your followers' Home timelines (across all instances).
  2. The Local timeline of your instance (everyone on your instance who's looking).
  3. The Federated timeline of every instance whose users follow you.

What this means

When you post, you're talking to three audiences simultaneously:

  1. People who chose to follow you. Most engaged.
  2. Strangers on your instance browsing Local. Discovery audience.
  3. Strangers on other instances browsing Federated. Smaller discovery audience.

Visibility settings

Each post has a visibility:

  • Public: all three audiences see it.
  • Unlisted: doesn't show on Local or Federated, but is still public on your profile.
  • Followers only: only your followers see.
  • Direct (DM-style): only mentioned users.

When to use which

  • Public: default. Most content.
  • Unlisted: for "second" posts that don't deserve to dominate timelines (e.g., reply-style follow-ups).
  • Followers only: for content meant for your community, not for discovery.
  • Direct: for one-on-one. Remember Mastodon DMs aren't private from server admins.

What "Local" being a thing changes

Some instances have very active Local timelines. People scroll Local looking for new accounts to follow. If you're on a topical instance, the Local timeline is a small but real discovery surface.

This is one reason picking a topical instance can pay off — your Local audience overlaps with your niche.

Common myths

  1. "Visibility is complicated." Not really. Public for most things; the rest is rare.
  2. "CW is censorship." It isn't. Posts with CW are still public; readers choose to expand.
  3. "My profile doesn't matter, my posts do." Both matter. Profile decides who follows; posts decide what they see after.

Action Steps

  1. Set up your profile if you haven't: display name, handle, bio with hashtags, header image.
  2. Verify your website link (add the Mastodon rel="me" link to your site).
  3. Pin 2-3 posts that represent your best work.

Profile setup on Mastodon is a 30-minute exercise that pays off forever. Next lesson: how hashtags work as the actual algorithm.