Bluesky hashtags: how tags work and how to use them well

Type # in front of a word on Bluesky and it turns into a link. Tap it and you see other posts with the same tag. That part is simple. What is less obvious is exactly which text becomes a tag and which does not, and why a hashtag in a fancy font does not behave like a normal one.

The rules below come from the code that detects tags in Bluesky’s open source library (detection.ts and util.ts in bluesky-social/atproto). That is the code the official app uses when it turns your text into links.

What becomes a hashtag

A tag starts with # (the full width οΌƒ used in Japanese and Chinese text works too) and runs until the next space. Bluesky then applies a few rules:

  • It must start the post or follow a space. word#tag is not a tag.
  • It cannot be only numbers or punctuation. #2026 does not become a tag. #2026goals does.
  • Punctuation at the end is dropped. In Loving #BlueskyTips! the tag is BlueskyTips, without the !.
  • It ends at the first space. #web dev gives the tag web, and dev stays plain text. Write #webdev or #WebDev.
  • It can be up to 64 graphemes long. A longer word after # is not turned into a tag.

Some quick examples:

You type Tag Bluesky creates
#bookstodon bookstodon
#2026 none (numbers only)
#2026reads 2026reads
#ArtistsOnBluesky! ArtistsOnBluesky
#web dev web
email#tag none (no space before #)

Styled hashtags look good but stay hidden

This is the part that catches people out. A hashtag written in a styled font, such as #𝐁𝐨𝐨𝐀𝐬, is still a tag, because the bold letters are valid characters. But it is a different tag from #Books. The bold B is a separate Unicode character from the plain B, so posts with #𝐁𝐨𝐨𝐀𝐬 do not show up for someone who taps or searches #Books.

So there are two kinds of use:

  • For reach, use plain hashtags. If you want people browsing a topic to find your post, write the tag in normal letters.
  • For decoration, styled tags are fine. A styled tag at the end of a post can act like a signature or a series label, for example #π•„π• π•Ÿπ••π•’π•ͺπ•„π•¦π•€π•šπ•” on your own weekly post. Just know that it will mostly be found through your profile, not through the tag.

The Bluesky hashtag generator gives you both: type your words, copy the plain tags for reach, and use a styled version only where you want the look.

How many hashtags to use

Every tag you write in a post counts toward the 300 grapheme post limit, including the # and the space before it. Three tags of ten letters take about 33 graphemes, more than a tenth of the post.

A few habits that keep posts readable:

  • One to three tags that describe the post are usually enough.
  • Put tags at the end or work one into the sentence, rather than a long block that pushes the message down.
  • Use CamelCase for multi word tags, like #ArtistsOnBluesky. It reads better, and screen readers have a better chance of reading the words separately.

Before you post, paste the full text into the Bluesky character limit checker to see graphemes and bytes together. If you are writing the post from scratch, the caption generator gives you a starting point to edit.

Quick answers

Why is my hashtag not a link on Bluesky? Check three things: there is a space before the #, the tag is not only numbers or punctuation, and it is no longer than 64 graphemes.

Do Bluesky hashtags care about capital letters? You can write tags in any case, and CamelCase makes long tags easier to read. Tap the tag after posting to check which posts it shows.

Can I use emoji in a Bluesky hashtag? An emoji right after the # with no space becomes part of the tag text, but few people search that way. Put emoji outside the tag and keep the tag itself in plain letters.

βœ“Copied to clipboard!