Mastodon Hashtag Not Showing in Search: Fix Steps

You created a hashtag on Mastodon and expected it to appear in search results, but it shows no posts or does not appear at all. This happens because Mastodon’s search engine indexes content differently than traditional social platforms. Mastodon does not automatically index every post with a hashtag — the server must first process and cache the tag data. This article explains why a hashtag fails to appear in search and provides step-by-step instructions to fix the problem.

Why Mastodon Hashtags Do Not Appear in Search Results

Mastodon uses a search engine called Elasticsearch to index posts, profiles, and hashtags. By default, Mastodon instances do not enable full-text search. When full-text search is disabled, the search function can only match exact account names or post IDs, not the hashtag text inside a post. Even when full-text search is enabled, the indexing process runs on a schedule, usually every few hours. A hashtag you just created may not be visible in search results until the next indexing cycle completes.

Another common cause is that the instance administrator has not configured Elasticsearch correctly. Without a working connection between Mastodon and Elasticsearch, no hashtags will be indexed. Finally, if your post is from a federated server that is not fully synced to your instance, the hashtag may exist on the remote server but not be searchable locally.

Steps to Fix a Missing Mastodon Hashtag in Search

Follow these steps in order. Start with the simplest checks and move to server-level fixes only if needed.

1. Wait 24 hours for automatic indexing
   Mastodon instances typically re-index content every 6 to 24 hours. If you posted a hashtag less than a day ago, wait and check again after 24 hours. This is the most common reason for a missing hashtag.
2. Search for the exact hashtag including the hash symbol
   In the Mastodon search bar, type the hashtag exactly as you posted it, including the # symbol. For example, type #projectupdate instead of just projectupdate. Mastodon treats these as different queries.
3. Make sure the post is public and not unlisted
   Only public posts are indexed for search. If your post visibility is set to Unlisted, Followers-only, or Direct, the hashtag will not appear in search results for other users. Change the post visibility to Public before posting with a hashtag.
4. Check if full-text search is enabled on your instance
   Open the Mastodon web interface and click the search bar. If you see a message like “Full-text search is not enabled on this server,” the instance administrator needs to enable it. Contact your server admin or check the instance settings. Full-text search is controlled by the FULL_TEXT_SEARCH environment variable set to true in the Mastodon configuration.
5. Force a manual re-index from the server terminal
   If you are the instance administrator, SSH into the server and run the following command: tootctl search deploy. This command triggers a full re-index of all posts, profiles, and hashtags. The process may take several minutes depending on the database size. After the command completes, check the search results again.
6. Verify Elasticsearch is running and connected
   Run curl http://localhost:9200 from the server terminal. If Elasticsearch is running, you will see a JSON response with a status of 200. If the connection fails, restart Elasticsearch with sudo systemctl restart elasticsearch and then run tootctl search deploy again.

If the Hashtag Still Does Not Appear After These Steps

Hashtag shows zero posts even though posts exist

This usually means the index is corrupt or outdated. Run tootctl search deploy --clean to rebuild the index from scratch. The --clean flag removes the old index before creating a new one. This can take longer but resolves most corruption issues.

Hashtag appears in search on the home instance but not on remote instances

Federation delays can cause this. Remote instances may not have received the post yet. Check the remote instance’s search after 48 hours. If it still does not appear, the remote instance may have disabled full-text search or may be blocking your instance.

Hashtag contains special characters or spaces

Mastodon hashtags can only contain letters, numbers, and underscores. Spaces, hyphens, and punctuation break the tag. If your hashtag includes a space, Mastodon treats only the first word as the tag. Remove any special characters and repost.

Mastodon Full-Text Search vs Basic Search: Indexing Behavior

Item	Full-Text Search Enabled	Basic Search (Default)
Hashtag indexing	Indexed from post body text	Not indexed from post body
Searchable content	Post text, hashtags, account names	Account names and post IDs only
Index update frequency	Every 6–24 hours or on manual command	Real-time for account names only
Server resource usage	Higher CPU and memory for Elasticsearch	Minimal
Configuration variable	FULL_TEXT_SEARCH=true	FULL_TEXT_SEARCH=false (default)

You can now diagnose and fix a missing Mastodon hashtag in search results. Start by waiting for automatic indexing and verifying the post visibility. If the problem persists, contact the instance administrator to enable full-text search or run the tootctl search deploy command. For persistent index corruption, use the --clean flag to rebuild the index from scratch. Always use public visibility for hashtags you want others to discover.