Mastodon Character Limits
Mastodon is open source, so its limits can be read straight from the code each server runs. Here is every limit in the current release, how links and mentions are counted, and why your server’s number may differ.
Short answer
A Mastodon post can be 500 characters on a standard server. Every link counts as 23, and a mention like @[email protected] counts only as @name. Bios also hold 500, display names 40 (30 before Mastodon 4.6) and usernames 30. Some servers run modified software with higher limits.
All Mastodon character limits
These are the defaults in Mastodon 4.7.3, the latest release on October 14, 2026. Server admins can run older versions or modified code, so a few numbers can differ on your server.
| Field | Limit | Notes |
|---|---|---|
| Post | 500 | Includes the content warning text. Links count 23; remote mentions count as @name. |
| Bio | 500 | Same rules as posts: links count 23. |
| Display name | 40 | Raised from 30 in Mastodon 4.6.0 (June 2026). Mastodon’s user guide still says 30. |
| Username | 30 | Letters, numbers and underscores. |
| Profile fields | 4 | Label and value up to 255 characters each. |
| Poll options | 4 × 50 | Up to 4 choices of 50 characters each in the current code. The user guide still says 25 per choice, which older servers may enforce. |
| Alt text | 10,000 | Per image or video. Raised from 1,500 in Mastodon 4.6.0. |
| Media per post | 4 images | Or 1 video, 1 GIF or 1 audio file. Since 4.6.0 a post can have media and a poll together. |
How Mastodon counts characters
When you publish, the server runs a length check that works in four steps. We read it in the Mastodon source code:
- Join the content warning and the post. Both share one budget.
- Swap every link for 23 characters. Only links that start with http:// or https:// get this treatment. A bare “example.com” counts letter by letter.
- Shorten remote mentions. @[email protected] becomes @alice. A mention of someone on your own server already looks like that.
- Count graphemes. Each visible character counts 1, including a flag or family emoji.
Some results from the counter on this page:
| Text | Characters you see | Mastodon count |
|---|---|---|
Hi @[email protected] and https://example.com/x | 51 | 37 |
Reading list: https://example.org/2026/10/a-very-long-article-title-goes-here | 77 | 37 |
Thanks @[email protected]! 🎉 | 28 | 14 |
Docs at example.com | 19 | 19 |
Finding your server’s limit
Stock Mastodon has 500 written into its code; there is no admin setting for it. Servers with a bigger number run a modified version or other software that speaks the same protocol. Every server publishes its limit in its instance information (configuration.statuses.max_characters in the API), along with how many characters it reserves per link. In practice the simplest check is the countdown in your server’s compose box, which starts at that number.
Writing tips for Mastodon
- Keep the full link. With https:// in front, any link costs 23, so shortening it saves nothing and hides where the link goes.
- Mention people by full address. The @server part doesn’t count toward the limit, and it makes sure the right person is notified.
- Budget for content warnings. A 40-character warning leaves 460 for the post.
- Write real alt text. With up to 10,000 characters per image, there is room to describe charts and screenshots properly.
- Thread longer posts. The Thread Splitter has a Mastodon mode with your server’s limit, counts links as 23 and remote mentions as @name, and numbers each part.
- Moving a post from X? Anything that fits X’s 280 fits Mastodon’s 500 with room to spare, unless it contains long addresses typed without https://, which X counts as 23 and Mastodon counts in full.
For plain counts of characters, words and lines, use the Character Counter or the Word Counter.
Sources
Checked against these pages on . Platforms change their limits; if you spot a difference, tell us and we will re-check.
- Mastodon documentation — Posting
- Mastodon documentation — Profile
- Mastodon documentation — Instance entity
- Mastodon documentation — accounts API
- Mastodon source v4.7.3 — status length validator
- Mastodon source v4.7.3 — account model
- Mastodon source v4.7.3 — poll options validator
- Mastodon changelog (4.6.0, June 17, 2026)
Frequently asked questions
What is the Mastodon character limit?
A standard Mastodon server allows 500 characters per post. Every link counts as 23 characters, and a mention of someone on another server, like @[email protected], counts only as @name.
Why does my Mastodon server allow more than 500 characters?
Stock Mastodon has 500 written into its code. Servers with a higher limit run a modified version or other compatible software. Your server reports its own limit, and the counter in its compose box always counts down from the right number.
Does the content warning count toward the limit?
Yes. Mastodon adds the content warning text to the post text and checks the total against 500, so a long warning leaves less room for the post.
How long can a Mastodon display name be?
Forty characters on Mastodon 4.6 and later. Servers still on an older version allow 30. Usernames can be up to 30 characters of letters, numbers and underscores.
How long can alt text be on Mastodon?
Up to 10,000 characters per image or video since Mastodon 4.6. Older servers allow 1,500.