A Mastodon post is 500 characters by default, and each visible character (grapheme) counts as 1. A Korean syllable is 1 character and an emoji is 1 character. What you type is not counted as is, though. A link counts as 23 characters whatever its length, a mention counts only the username without the server address, and the text of a content warning (CW) is added to the body text. This article uses Korean text as its example, so Korean example sentences are kept as written. The values below come from the official Mastodon documentation and the public source code, checked with the Geuljasu count functions.
How many characters can one Mastodon post have?
The Mastodon user documentation (Posting to your profile) says the default character limit is 500. The API documentation that describes a server also has a max_characters field per server, with an example value of 500. The length-check code in the Mastodon repository (status_length_validator.rb) also sets the maximum to 500. Because the documentation calls it a default, servers whose operators changed it and forked software were not checked this time. Look at the remaining-character counter on the server you post to once more.
We also checked the counting unit in the code. Text is split into graphemes, the chunks a person sees as one character. That differs from services that count bytes, which we compare below. With the Geuljasu function, 「가」 repeated 500 times is 500 characters (passes) and 501 times is 501 characters (over).
How do links and mentions count?
The official documentation and the code state the same rules.
- Link: counts as 23 characters regardless of length.
- Mention: only the username is counted, not the server address (domain).
Reading the code shows one more detail. Only addresses that start with a protocol such as https:// are treated as links. The table applies this rule to character counts measured with the Geuljasu function.
| What you typed | Characters typed | Characters Mastodon counts |
|---|---|---|
| https://docs.joinmastodon.org/user/posting/ | 43 | 23 |
| @hello@example.social | 21 | 6 |
| docs.joinmastodon.org/user/posting/ (no https://) | 35 | 35 |
| Hashtag | as typed | as typed |
The first two rows are shortened, but an address without a protocol and a hashtag have no shortening rule in the code, so they count as typed. When you paste a long address, putting https:// in front works in your favor. For a mention, @username is enough for someone on your own server, and @username@server for someone on another server counts the same length.
How many body characters are left with a content warning?
A content warning is a short warning line placed before the body. The source code joins the content warning text and the body text and counts them together when it checks the length. So every character of the warning leaves less room for the body. 「스포일러 주의」 (Spoiler alert) is 7 characters with the space, so the body can be 493 characters. Each link also takes 23 characters of its own.
With the Geuljasu function, 477 Korean characters followed by one link make exactly 500, and 478 characters make 501 and go over. The 454 and 447 for two links come from subtraction; just remember that a space between links counts as one character too. If your post has no content warning, you can skip this section.
How do emojis count, and should I worry about bytes?
Mastodon counts an emoji as 1 grapheme, which is 1 character. The family emoji joins 4 people and 3 joiner characters, so it is 25 bytes in UTF-8, but it is 1 character on Mastodon. With the Geuljasu function, 500 family emojis in a row are 500 characters (12,500 bytes) and pass. There is no separate byte limit, so even with many emojis the only limit you hit is 500 characters. Flag, heart and skin-tone emojis all came out as 1 character too.
The rules change when you post the same text to another service. Putting the Bluesky article and the Threads article side by side gives this.
| Service | Post limit | How emojis and links count |
|---|---|---|
| Mastodon | 500 characters (default) | Emoji is 1, link is 23, mention is username only |
| Bluesky | 300 characters and 3,000 bytes | At most 300 graphemes and at most 3,000 bytes |
| Threads | 500 characters | Emojis counted in UTF-8 bytes, at most 5 links |
Mastodon and Threads share the number 500 but count differently. A Mastodon post copied to Threads can go over the limit because of emojis and links, while a Threads post usually fits within the Mastodon limit. The way text is split (Intl.Segmenter) can also differ from the server for very new emojis, depending on the browser’s Unicode version.
In what order should I check before posting?
The real input screen does this calculation for you, but when you draft text elsewhere you can estimate it in the order above. To see where text goes past the limit, put 500 into the Character Limit Trimmer and paste your text. For a post without links, the count with spaces in the Word Counter is the Mastodon count as it is.
Code to check it yourself
Paste this into the browser console to count with the rules above in simplified form. Only links that start with https:// become 23 characters, and mentions lose their server address. The real server recognizes links and mentions more precisely, so near the limit follow the number on the input screen.
// Join the warning (cw) and body; a link counts 23, a mention counts only the username
function mastodonCount(body, cw = '') {
const text = body
.replace(/https?:\/\/\S+/g, 'x'.repeat(23))
.replace(/@(\w+)(@[\w.-]+)?/g, '@$1');
const seg = new Intl.Segmenter('ko', { granularity: 'grapheme' });
return [...seg.segment(cw + text)].length;
}
mastodonCount('https://docs.joinmastodon.org/user/posting/'); // 23
mastodonCount('@hello@example.social'); // 6
mastodonCount('가'.repeat(500)); // 500
Frequently asked questions
Are hashtags and custom emojis counted in a shortened way?
In the source code, only links and mentions were shortened. A hashtag counts as typed including the #, and a server’s custom emoji has no shortening rule in the code either, so the characters typed as :name: count as they are. What the screen shows can differ by server version, so near the limit check the number on the input screen.
Does a content warning have its own character limit?
We did not find a separate limit for content warnings in the official user documentation. The code does check whether the warning and body together pass 500 characters, so a longer warning leaves a shorter body.
How many characters can a poll choice have?
The user documentation says a poll can have up to 4 choices and each choice can be up to 25 characters. This limit applies separately from the 500 characters of the post body. You can count characters right away in the Word Counter, and use the Byte Counter when you want bytes.