> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postqueen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Mastodon

> How to add Mastodon to your system

<img src="https://mintcdn.com/forceplay/LL5FipRv-7nhg1To/images/channels/mastodon.svg?fit=max&auto=format&n=LL5FipRv-7nhg1To&q=85&s=cc7df05ba8014f2b2d8e6270659ded0e" alt="Mastodon" height="44" noZoom style={{ height: "44px", marginBottom: "1.25rem" }} data-path="images/channels/mastodon.svg" />

<Snippet file="never-share.mdx" />

## What she can post to Mastodon

Your instance sets the house rules and she works inside them. Five hundred characters, media uploaded through the instance itself, and every status public.

<CardGroup cols={2}>
  <Card title="Character limit" icon="text-width">
    500 characters per status.
  </Card>

  <Card title="Media" icon="image">
    Images and video, uploaded to your instance media endpoint with alt text kept. She adds no count limit of her own, so the instance rules apply.
  </Card>

  <Card title="Post types" icon="layer-group">
    A status, then replies threaded underneath it as comments.
  </Card>

  <Card title="Analytics" icon="chart-line">
    None. Ten connectors report numbers back to her, and Mastodon is not one of them.
  </Card>
</CardGroup>

| Area           | Detail                                                                                                                                                                                 |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Post settings  | Nothing beyond `__type`: [Mastodon settings](/public-api/providers/mastodon).                                                                                                          |
| Which instance | Every Mastodon post lands on the single instance named in `MASTODON_URL`. It is read per install, not per channel, so connecting accounts on two different instances is not supported. |
| Connect flow   | One step, OAuth2 against the instance in `MASTODON_URL`, with the scopes `write:statuses`, `profile` and `write:media`.                                                                |
| Automations    | None on this network.                                                                                                                                                                  |
| Publish rate   | Five posts at a time, since Mastodon instances are usually generous.                                                                                                                   |

<Warning>
  Every status she sends is posted with visibility `public`. There is no unlisted, followers-only or direct option on this connector.

  If the instance turns your account off, reconnecting is the only fix, and the message you will see is **"Your login is currently disabled"**.
</Warning>

## Self-hosting

<Info>
  On PostQueen Cloud this channel is ready: open **Add Channel** and pick it.
  Running your own instance? You register the application yourself:
  [Set up Mastodon on your own instance](/installation/providers/mastodon).
</Info>

<Snippet file="next-steps-provider.mdx" />