Mastodon Character Limit 500: How Links and Mentions Count

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).

The official documentation and the code state the same rules.

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 typedCharacters typedCharacters Mastodon counts
https://docs.joinmastodon.org/user/posting/4323
@hello@example.social216
docs.joinmastodon.org/user/posting/ (no https://)3535
Hashtagas typedas 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.

What you type vs. what Mastodon countsWhat you type: Link, 43 characters, Mention, 21 characters, Content warning, 7 characters, Family emoji, 1 (25 bytes) → What Mastodon counts: Link, 23 characters, Mention, 6 characters, 7 deducted from the body limit, 1 characterWhat you typeLink, 43charactersMention, 21charactersContent warning, 7charactersFamily emoji, 1(25 bytes)What MastodoncountsLink, 23charactersMention, 6characters7 deducted fromthe body limit1 character
What you type vs. what Mastodon counts — Values measured with the Geuljasu function plus the official rules

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.

Characters left for the rest of the bodyNo link or warning: 500chars; Warning, 7 chars: 493chars; 1 link: 477chars; 2 links: 454chars; 2 links + warning: 447chars0100200300400500No link orwarning500charsWarning, 7 chars493chars1 link477chars2 links454chars2 links + warning447chars
Characters left for the rest of the body — 500 minus links (23 each) and a content warning (7), calculated directly

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.

ServicePost limitHow emojis and links count
Mastodon500 characters (default)Emoji is 1, link is 23, mention is username only
Bluesky300 characters and 3,000 bytesAt most 300 graphemes and at most 3,000 bytes
Threads500 charactersEmojis 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?

Checking order before posting to MastodonWrite warning and body → Join warning and body; Join warning and body → Replace https:// links with 23; Replace https:// links with 23 → Remove server from mentions; Remove server from mentions → At most 500 graphemes?; At most 500 graphemes? → Post (Yes); At most 500 graphemes? → Shorten the text (No); Shorten the text → At most 500 graphemes?YesNoWrite warning andbodyJoin warning andbodyReplace https://links with 23Remove server frommentionsAt most 500graphemes?PostShorten the text
Checking order before posting to Mastodon — Follow the order in which the code counts the length

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.

Basis: Mastodon official docs "Posting to your profile" (default 500 characters, links count as 23, mentions count only the username, poll choices 4 and 25 characters), Mastodon official API docs "Instance" (configuration.statuses max_characters and characters_reserved_per_url), Mastodon repository app/validators/status_length_validator.rb (checked on the main branch 2026-11-16), Geuljasu character and byte count functions. Sources checked on 2026-11-16. Byte values in this post are calculated the same way as the Geuljasu tools; real SMS services may follow different rules set by carriers and sending providers.

The full counting rules are on Methods and standards.

Tools related to this post