How do I stop receiving email notifications from Mastodon?

Mastodon sometimes may send you emails when certain things happen on your account. You can switch off these emails by doing the following:

  1. Log in through your server’s website or through the web app
  2. Click on ⚙️ Preferences
  3. Click Notifications on the left of the screen (or on the mobile site click ☰ and then Notifications in the menu)
  4. UN-tick all the boxes in the section marked Events for e-mail notifications
  5. Click the Save Changes button at the top of the screen

This won’t affect notifications you get within Mastodon itself, it just switches off the emails.

↩ Back to the front page

How do I opt into full text search on Mastodon?

Since version 4.2.0, Mastodon allows full text search where the entire contents of public posts are included when people do searches.

For privacy and safety reasons, the full text search feature is entirely on an opt-in basis. By default your posts are NOT available to search by that method, and you have to actively opt into full text search to make your public posts searchable without hashtags.

To opt into full text search:

  1. Log in through your server’s website or the web app
  2. Click on your profile icon, this will take you to your profile page
  3. Click on the Edit Profile button
  4. Click on the tab at the top of the screen labelled Privacy & Reach
  5. Tick the box marked Include public posts in search results
  6. Click the Save Changes button at the bottom of the screen

If you change your mind, do the same steps again but untick the box and then save changes.

What if I don’t want to be searchable by full text?

By default, your posts are NOT part of the full text search system. You have to actively opt in using the steps above if you want people to be able to search the entire text of your public posts.

If you don’t opt in, then your public posts are only searchable by hashtag.

What if I want some of my posts to be searchable, but others not searchable?

The search system on Mastodon only shows posts using the Public visibility setting. If you create a post with any other visibility setting it will not show up in search results.

If I opt in, does it make my older public posts full text searchable too?

No. Opting into full text search only applies to public posts written after the opt-in happened, because it tags them with a special tag that allows full text searching. These tags would not be on older public posts, so they won’t be full text searchable (but they will still be hashtag searchable).

If I opt into full text search, can my public posts still be found by hashtag?

Yes. Your public posts will still show up in hashtag searches whether or not you’ve opted into full text search.

If I opt into full text search but my server doesn’t offer full text search, will my public posts still be searchable on other servers?

Yes. When you opt in, the text of your public posts will be picked up by the search system on servers that do offer full text search, even if your server doesn’t.

Why doesn’t every server offer full text search?

Full text search requires a server to have an extra service called elasticsearch. This costs extra, and some servers may not have the resources to pay for it.

There are also some servers that prefer to keep things on a hashtag-only basis as they see it as an extra layer of safety.

So, now that there’s full text search, should I carry on using hashtags?

Yes! Using hashtags is still a good idea for several reasons:

  • Many people follow hashtags, so your post will get more visibility if you include tags
  • Not everyone uses full text search
  • Some servers don’t offer full text search due to its extra cost
  • Hashtags give a clear sense of topic, they say what the post is about. Text can be ambiguous and unintentional, whereas hashtags show clear intended topics.

↩ Back to the front page

Fedilab for Android

Third party Mastodon, PeerTube & Fediverse app, free open source software, available from Google Play (paid) ⧉ & F-Droid (free) ⧉

General impressions

At first glance appears to be pretty standard, but once you start going through the options and settings there is so much more under the surface. Many, many useful features and good support for non-Mastodon Fediverse servers. It’s not the best-looking app, but that doesn’t matter because it does lots of things other apps cannot do.

Nice stuff

  • All the standard extras available the web interface such as post editing, pinned posts, hashtag follows, lists, filters, trending tags, trending posts etc.
  • All the timelines (Home, Local, Federated, Explore) are there, as are all the visibilities (Public, Unlisted, Followers-Only, Mentions-Only and Local-Only (for servers that support local-only posts))
  • Free open source software
  • Allows users to be muted just on home timeline while still appearing on lists, which is great for creating multiple separate timelines from the same account. (Also, you can set lists to automatically include home muted users.)
  • Scheduled posts and scheduled boosts, including boosts of own or others’ posts
  • Post drafts, automatically asks you if you close a message without posting it
  • Built-in translation, built-in dictionary and spell checker
  • Good support for non-Mastodon Fediverse server types including Pixelfed, PeerTube, Friendica etc. Also includes support for extra features on Mastodon forks such as Glitch and Hometown.
  • PeerTube interface is particularly good, allows all the options from the web interface including uploads, and Fedilab can easily be used as a dedicated PeerTube app
  • Customisable timeline and interface options, colour themes, adjustable text and icon sizes.
  • Conversation thread maps
  • Lets you fetch data from remote servers which allows conversations and profiles to be updated with information that hasn’t federated to your server yet.
  • Optional privacy features for links such as UTM stripping, and using alternative frontends for links to popular services (for example Nitter to view Twitter links, Invidious to view YouTube links etc).
  • Lots more options such as automatic cache clearance.

Not sure one way or other

  • Fedilab is a paid app on Google Play but free-of-charge on F-Droid. This is as the developer wishes to encourage people onto alternatives to Google Play.

Potential drawbacks

  • Some of the formatting could be slicker and neater, for example metadata tables on profiles look a bit messy
  • Some English translations slightly odd, such as “trending messages” when it means trending posts
  • Occasional weird bugs, for example the Manage Timelines page brings up a “No timelines was found on this instance” error message

Hints & Tips

  • Polls can be added to posts by clicking the attachment button (the paperclip) and selecting the poll icon
  • You can jump to the top of a timeline by double-tapping the timeline’s icon

↩ Back to the front page

How do I stop seeing the same boosted post again and again in Mastodon?

If a post is boosted by a lot of people, you may see it repeatedly in your timeline. This can be annoying if you’re tired of seeing it.

There is already a feature in Mastodon to prevent this happening, called Group Boosts, and it is on by default, you don’t need to do anything to switch it on. Unfortunately, it is hardcoded to allow boosts to repeat after 40 other posts have been in your timeline. This limit worked okay in the early days of the Fediverse when things were quieter, but nowadays with millions of people online you are a lot more likely to see repeated boosts.

This 40 posts limit cannot currently be adjusted by users or admins, but hopefully the developers could allow this to happen. If you are comfortable using github, you can vote for this limit to be adjustable by giving a thumbs up to the first post in this thread ⧉.

Is there any kind of workaround that I could use in the meantime?

There’s nothing that directly adjusts the 40 post number, which is why so many people have voted for it to become adjustable. However, if there’s a post you really want to stop seeing, you might want to try using filters to hide an over-boosted post.

What if I see one particular account boosting too many different boosts?

That’s a different issue, you can completely hide the boosts made by specific accounts.

↩ Back to the front page

Scheduling posts on Mastodon

Post scheduling means you write posts now, and they are automatically posted later at times and dates of your choosing.

This is very useful for accounts that need posts to go out at particular times of day, for example to reach people reading their feeds in particular time zones, or to accompany scheduled live events such as streams or radio shows.

Scheduling through third party apps

If you are using certain third party apps such as Tusky and Fedilab you will find scheduling options built into their posting interfaces. Fedilab also runs a website interface at FediPlan ⧉ which lets you access the scheduling feature even without the app.

If you’re techy and want to self-host a scheduling app, there’s a new free open source third party web app called Mastodon Scheduler ⧉.

Professional post scheduling services

There are now commercial companies offering advanced post scheduling services that include compatibility with Mastodon and other social networks. The two most prominent at the moment are Publer ⧉ and Buffer ⧉.

Why doesn’t Mastodon have a built-in scheduler?

This is the weird part… Mastodon does actually have a fully functional built-in scheduler buried deep in its code! However, for some unexplained reason, the official web interface and official apps don’t yet give you any way to access it. This means you can only use Mastodon’s post scheduling system through third party apps and services via the Mastodon API.

If you’re comfortable using Github, you can vote for an official Mastodon scheduling interface to be added by giving a thumbs up at this issue ⧉.

↩ Back to the front page

How to block (defederate) a server on Mastodon

Each server on the Fediverse is independent, and can choose to cut off connections to any other server if it wants to do so. This process of blocking other servers on the Fediverse is known as “defederation” or “fediblocking”.

Usually this is done for the sake of user safety, for example if another server is failing to moderate abusive behaviour, but it can be for any reason that the server admin considers important.

If you’re an admin on a Mastodon server, here is how to defederate other servers on the Fediverse:

  1. Log into your admin account on your server’s website
  2. Go to Preferences > Moderation > Federation
  3. Click Add New Domain Block
  4. Enter the domain name of the server you want to block (for example “threads.net”)
  5. From the Severity dropdown menu select Suspend
  6. Optionally add comments if you want to remind yourself why you blocked them, or if you have a public list that explains your server’s blocks
  7. Click Create Block

Once you’ve done this, your server will refuse connections from the blocked server and any follows from those servers will be removed.

These blocks work for any Fediverse server type, so you can block non-Mastodon servers as well.

Do I have to do this for every single server I want to block?

By default, blocks are done one at a time. However, you can also import ready-made blocklists which let you block lots of servers at once.

Do I need to defederate subdomains separately too?

No. If you block the main domain, this automatically also defederates all subdomains of that domain.

Is there a less drastic alternative to blocking?

Yes, you can choose Limit from the Severity menu instead of Suspend. Limiting (also known as Silencing) does not cut off connections, and allows follows to carry on, but it hides all posts from that server unless people are following the account that makes them.

What if I change my mind? How do I unblock servers?

To remove a domain block:

  1. Log into your admin account on your server’s website
  2. Go to Preferences > Moderation > Federation
  3. Click on the domain you want to unblock
  4. Click Undo Domain Block

If I unblock a server, will people’s follows be restored?

When an admin defederates a server, that cuts off all the follows between that server and the admin’s server.

Unblocking a server allows people to follow each other again, but it does not automatically restore follows that existed before the defederation happened. This is an important reason to consider carefully before defederating a server.

If you want to distance yourself from a server but don’t want to cut off follows, use the Limit/Silence option instead of Suspend.

↩ Back to the front page

Tusky for Android

Third party Mastodon app, free open source software, available from Google Play (free) ⧉ and F-Droid (free) ⧉

General impressions

Solid, reliable and mature with continual development and updates. Works the way you would expect it to, and matches up nicely with the website interface. This is what the official Android app should have been.

Nice stuff

  • One of the longest-supported Mastodon apps, been around longer than the official app
  • Feels very intuitive, arranged logically
  • Free open source software
  • Lots of features that are missing from the official app and/or website, such as scheduled posts, drafts, reversal of reading order, image cropping etc.
  • Other features include post editing, image focus editing, bookmarks, lists, polls, hashtag following, filters, private profile notes, all post visibilities including Unlisted, all timelines
  • Custom tabs, you can pick up to five from Home, Local, Federated, Notifications, DMs, Trending Hashtags, Lists, Hashtag Columns
  • Hashtag tabs can include multiple hashtags in one tab, and you can have multiple separate hashtag tabs, which is really useful for creating your own custom themed timelines
  • Switch between tabs very easily by swiping (swiping can be deactivated too)
  • Support for multiple accounts at once, with separate settings pages for each account
  • People sick of clout-chasing can switch off all the boost/favourite/follower numbers, which can be good for mental health
  • Warning icon to remind you to add text descriptions

Potential drawbacks

  • No option to view trending posts
  • Custom tabs are fantastic, but the five tab limit can be frustrating
  • Verification of links on profiles not very clear, the icon could be confused with fake verification icons made with custom emoji
  • Profile descriptions formatted slightly messily, especially metadata elements
  • Some people overlook the Add Poll button as it’s sort of hidden in the attachment menu

Hints & Tips

  • Tusky is a volunteer-run project providing free software, you can donate to keep it going at the Tusky Open Collective page ⧉
  • To see your own profile page, tap your profile icon twice (once to open the settings page, then again to show your profile page)
  • To make a draft, start writing a post and close it without actually posting it . You can find a complete list of drafts from the settings page.
  • To add a poll, click the attachment button 📎 and then select Add Poll

↩ Back to the front page

Toot! for iPhone & iPad

Third party Mastodon app, closed source, available from Apple’s App Store (paid) ⧉

General impressions

Lots of personality, presented in a whimsical and fun style, not corporate at all.

Nice stuff

  • Mature and stable, one of the longest-maintained apps, been around longer than the official apps
  • Supports all timelines (home, federated, local), explore/trending tab, lists, hashtag following
  • Supports post editing
  • London Underground-style colourful discussion maps make threads much easier to navigate
  • Laid out clearly with text explaining things instead of blank icons, support for variable font size too
  • Allows multiple accounts at once and easy-to-use switcher in corner of screen
  • Unique and fun easter eggs including “user scanning”, a pool simulator with a mysterious scoring system and more
  • Timeline syncing between devices through iCloud
  • The “in-app purchases” are actually just parodies which you don’t need to buy, they don’t add any features

Potential drawbacks

  • Search box is awkwardly hidden in a menu
  • The message bubbles can feel a bit overwhelming when there are lots of them, but they can be switched off

Hints & Tips

  • You can find the search box by going to the Home or Notifications tab, then clicking ⋯ and then Search
  • To find the Explore, Local and Federated feeds, click your server’s icon in the bottom right corner and then select the feed you want from the menu at the top of the screen

↩ Back to the front page

Importing ready-made server blocklists on your own Mastodon server

Mastodon servers can choose to block other servers, and by default this is done manually one at a time. However, this can get cumbersome if there are lots of servers you need to block quickly, especially if you’re running a new server with no blocks at all yet.

To make the process easier, servers admins can import pre-written server-level blocklists from sites such as oliphant.social ⧉. Once you have a blocklist downloaded, here’s how to add it to your own server:

  1. Log in on your server’s website using your admin account.
  2. Go to Preferences > Moderation > Federation
  3. Click the Import button at the top
  4. Browse for the blocklist’s .csv file, then click Upload
  5. You will be presented with a list of servers to block. If there are servers with existing connections to your server, they will be automatically unticked. If you want to include these in the block, tick them.
  6. When you want to implement the blocklist, click Import in the top right corner of the list and click OK to confirm.

Once the list is successfully imported, the blocks will appear alongside your existing blocks. If necessary, you can remove blocks from the list just like any manually added block.

Will it block people that have already followed me, or that I already follow?

Before any blocks happen, the blocklist import process will highlight servers on the list that your server already has connections to. You will be given the option of either going ahead with blocking those servers, or leaving them off the blocklist. By default it will leave them off the blocklist, unless you choose to add them back in.

If you block a particular server, then all the follows and followers from that particular server will lose their connections to your server.

↩ Back to the front page

Deleting posts automatically in Mastodon after a certain time period

Posts in Mastodon can be set to automatically self-destruct after a certain time period, with exceptions made for posts you want to keep. Here’s how to do it:

  1. Log in through your server’s website or the web app
  2. Go to Preferences > Automated post deletion (on mobile web click ⚙️, then ☰, then Automated post deletion)
  3. Choose the Age threshold to set how long posts are around before they’re deleted
  4. Set the exceptions for posts you want to keep
  5. Tick the box at the top marked Automatically delete old posts
  6. Click the Save changes button

What if I change my mind? How do I stop posts being deleted automatically?

If you want to stop deleting posts automatically, UN-tick the box marked Automatically delete old posts, and click the Save changes button.

Will stopping the auto-deletion bring back posts that are already deleted?

No. Once a post is deleted it is gone. Be sure you want to use auto-deletion before you activate it.

I activated this but it hasn’t deleted posts that are way past the threshold. What’s going on?

If servers are busy, they create queues of tasks to work through. Automated deletion tends to go at the back of the queue, so it may take longer to happen than other tasks. If the settings are correct and it’s way past the deadline for the deletions to happen, ask your server’s admin for advice.

How does this affect server running costs?

When this feature is discussed, the issue of server running costs is often raised.

On the one hand, automated stuff always adds extra tasks for the server to carry out. On the other hand though, it would mean the server doesn’t have to store as much data so it would save money on storage costs, especially if the deleted posts have media attachments. It would also reduce storage for any servers that have federated the posts being deleted.

You would have to speak to your server’s admin to find out exactly how it affects their setup, as different servers may have different resources available.

I asked a couple of very large server admins for their thoughts on how this balances out. Both of them said the added tasks were insignificant compared to everything else the servers have to do. Both of them also said deleting posts (especially posts with media attachments) saves storage, but one of them added that there may be fees to be paid if the deletions happen for very recent posts. On their server, it would be cheaper to only delete posts more than 90 days old, and leave any newer posts intact.

↩ Back to the front page

How to use groups on Mastodon and the Fediverse

At the moment, most Fediverse groups work like this:

  1. Join a group by following its account address
  2. Posts from that group will start appearing in your Home timeline
  3. If you want to post something to the group, just include its account address in a public post
  4. If you want to leave a group, unfollow it

It’s somewhat similar to following hashtags, and people who have used email discussion lists will also find this structure very familiar.

The main Fediverse group provider at the moment is Guppe ⧉. It’s platform-neutral, their groups can be followed from all kinds of Fediverse servers including Mastodon, GoToSocial, Friendica etc. It’s also free open source software so anyone can start their own Guppe server if they want to.

Where can I discover existing groups?

I’ve compiled a curated list of interesting Fediverse groups on fedi.directory ⧉. I’ve tried to only list active groups with a respectful atmosphere.

Guppe has a list of their top 50 active groups at the bottom of their website at a.gup.pe ⧉.

You can also try searching for @a.gup.pe in the search box on Mastodon, this will show Guppe groups that at least one person on your server is following. However, bear in mind if a group has no followers from your server it won’t show up in searches.

How can I create a group? Are the groups moderated? What if I see something unsuitable?

Guppe groups don’t require any kind of registration, you can create a group simply by mentioning the group name in the form “@YourGroupNameHere@a.gup.pe”. However, because there’s no registration there is no group moderator either. Guppe groups rely on members reporting bad group posts the same way they would report bad non-group posts.

What do I do if I see spam or something unsuitable in a group?

Do exactly the same thing you would do if you saw spam/abuse outside the group on ordinary posts. Whatever kind of group you are following, you can report, mute and block just like you can with ordinary non-group posts.

When you report bad posts, the admins on your server (and possibly also the server of the spammer/troll) can take action to block it and remove it.

What if a group is really busy? How do I stop it overwhelming my timeline?

You can use Mastodon’s Lists feature to set up lists for groups, and then set those lists to hide posts from your Home timeline. This will let you keep groups in their own mini-timelines you can dip into whenever you want, without causing any posts to appear in your main timeline.

Groups federate content more effectively than hashtags

Hashtag follows and groups have some overlap, and appear to work in a similar way on the surface, but there are significant differences behind the scenes.

The biggest advantage of groups is you automatically see all of the group’s posts, even if they’re from accounts that haven’t federated to your server before. Because all the group’s posts are shared to all the members’ servers, you never miss a thing.

With hashtag follows, this mass federation doesn’t happen. Hashtag following means you will only see posts from accounts that already federate with your server. Hashtags are essentially passive filters for your server’s Federated timeline and do not actively draw in any new content.

What about Mastodon’s own built-in groups feature?

Mastodon has been developing a built-in groups feature for some time now, but it hasn’t been released yet. From the screenshots posted so far, it seems it will be more of a Facebook Groups type forum rather than a public discussion list. (You can see highly technical details and screenshots of this upcoming Groups feature on their github page ⧉).

However, it is unclear if Mastodon groups will work across the Fediverse or only on Mastodon. Guppe is platform-neutral, and will work on any kind of Fediverse server that supports microblogging including Mastodon, Friendica and others.

Can I set up my own Guppe server?

Guppe is free open source software, and if you have the necessary technical knowledge and resources, you can install your own Guppe server by following the instructions on the Guppe Github site ⧉.

Groups on Friendica

The Fediverse server type Friendica includes built-in group support, which works in a broadly similar way to Guppe. Creating a Friendica group requires a Friendica account, but anyone can join the group from other Fediverse server types including Mastodon servers.

A Friendica group can be moderated by the person who created it, and they can also add additional moderators to the same group.

Is there anything like Reddit on the Fediverse?

Yes! There’s a Reddit-style link aggregation and discussion platform called Kbin.

↩ Back to the front page

You don’t need link shorteners on Mastodon

All links on Mastodon count as 23 characters towards your post’s character limit, no matter how long they really are. Because of this, there is no need to use link shortener services on Mastodon.

Mastodon does this because it’s much better for privacy that links remain in their original form, as link shortener services tend to track the people that click on them. It also means the links will continue to work in the future and aren’t dependent on the existence of the link shortener service.

The official iPhone/iPad app counts it as more than 23 characters?

There’s a known bug on the official iPhone/iPad app ⧉ which causes links to count for more than 23 characters. A fix has been proposed but it hasn’t been released yet. In the meantime, you can avoid this bug completely by using third party apps such as Toot!, Ice Cubes and Ivory, or by logging in through your server’s website.

But I want to track people who click on my links!

You can use link shorteners to track people, but you probably shouldn’t. Also, some people may wonder why you are using link shorteners when all links count for 23 characters anyway.

Why is it 23 characters?

Apparently Twitter’s original built-in link shortener used 23 characters. So when Mastodon removed the need for shorteners, they emphasised this by only counting 23 characters for all links.

↩ Back to the front page

Using relays and scripts to quickly expand a server’s view of the Fediverse

By default, brand new Mastodon and Fediverse servers will be totally blank, with no users or posts visible at all. Searches will produce no results.

As people start signing up and posting and following accounts from other servers, the timelines and search results will start to fill up as the server starts noticing more of the Fediverse. However, this discovery process can be very slow to begin with, and those on new servers may sometimes be frustrated by the slowness.

Server admins can speed up this process by subscribing to relays which push new content to their server from other servers, or using scripts that fetch missing posts from threads and profiles.

How to subscribe to a relay server on Mastodon

  1. Log into your server’s website using your server’s admin account
  2. Go to ⚙️ Preferences > Administration > Relays
  3. Click Setup A Relay Connection
  4. Paste the URL of the relay into the box and click Save And Enable

⚠️ WARNING: Some relays are better moderated than others. Some relays may contain content that breaks your own server’s rules, or may even be illegal in your country. It’s really important to check what kind of content a relay contains before you connect your own server to it. Relays are usually based on specific servers, so you can see such a relay’s content by browsing its server’s Federated feed and reading that server’s rules.

Also, bear in mind large and general relays may fill your server with content that you mostly aren’t interested in, and use up lots of resources at the same time. Smaller, more specific relays may be much better suited to your server’s resources.

Finding general relays

There’s a list of Fediverse relays at RelayList.com ⧉. Please bear in mind the warnings above before using this list, and check that the content on the relays is suitable for your server.

FediBuzz Relay: Custom relays on specific topics

This is a new service that lets you subscribe to custom relays based on specific hashtags or specific other servers. This can greatly reduce the amount of resources required by relays, as it only sends posts that are relevant to the topics you have selected for your server. You can find out more on its website at relay.fedi.buzz ⧉.

Using scripts to fill in missing posts from profiles and threads

There’s a new tool called FediFetcher ⧉ which can be used to automatically backfill missing posts from profiles and conversation threads. It runs independently of the Fediverse server, but it needs access tokens for every user that it backfills for, so it is generally aimed at single-user servers or servers where the admin knows all the users. It also requires good technical skills for running the tool.

↩ Back to the front page

How to post a poll on Mastodon

It’s really easy:

  1. Log in through your server’s website or on an app
  2. Start a new post
  3. Click the poll icon, this usually looks like a bar chart 📊 (on some apps there may be no poll icon visible, but you can click the attachment icon and then select poll as an attachment)
  4. Write your question in the main part of the post
  5. Add up to four responses, and describe each option (you can use emoji too). Some servers running customised code may allow more than four responses.
  6. Set the duration, between 5 mins and 7 days
  7. Click Publish to post the poll!

Allowing multiple responses on polls

There’s a slightly hidden option when you’re posting a poll where you can allow people to choose more than one response. To switch on multiple responses:

  1. Log in through your server’s website
  2. Create the poll via the web interface as described above, but don’t post it yet
  3. Click on a circle next to one of the options, the circles will all change into rounded squares, and the poll will now allow multiple responses

If you want to go back to single response, click on a square to change it back to circles before you post.

Some third party apps also allow you to activate multiple responses for a poll.

⚠️ Warning about editing polls

You can edit polls the same way you edit posts, just go to ⋯ on the post and select Edit. However, when you edit the poll’s options or change its response type, it will automatically reset the poll’s results back to zero without any warning! (Editing the main text above the poll doesn’t reset it though.)

This behaviour is presumably to prevent abuse of the poll system, but the lack of warning can really catch people out (it certainly caught me out! 😅 ). For those comfortable using Github, there’s an open issue about this here ⧉.

I can’t find the poll button on my app!

Some third party apps have the poll button hidden away under the attachment button. Click attach, and then instead of choosing an image or video or audio file, choose a poll.

Some people have more than four options on their polls! How is this possible?

Mastodon is just one kind of server on the wider Fediverse. This means that many of the accounts you see on your timeline are on servers that have tweaked their Mastodon software to allow additional featured (such as more poll options), or are on totally different kinds of server altogether. You can escape the limits of standard Mastodon servers by moving to a different kind of Fediverse server.

↩ Back to the front page

How do I follow someone on Mastodon? How do I unfollow them?

You can follow someone on Mastodon by clicking on the Follow button on their profile page. You can go to someone’s profile page by clicking on their name.

You can unfollow them by clicking the same button again. The button may have a different label after you’ve followed them (Unfollow, Following etc), but it will be in the same place on the screen.

I know someone has an account on Mastodon etc and I’ve tried searching for their account, but it doesn’t show up in the search results. How do I follow them?

If you’re trying to get someone’s profile page to appear and nothing else works, you can use their account address to make their profile appear. Copy and paste their account address into the search box, and this will force your server to show you their profile page.

If you don’t know their account address but you have some other means to communicate with them, try asking them directly. They can find their account address on their profile page, it’s just below their display name. There’s more info on the account addresses page.

If you’re just wanting to discover new accounts that you haven’t heard of before, use the suggestions on the account discovery page.

↩ Back to the front page

How do I delete a post on Mastodon?

To delete one of your posts:

  1. Go to the post you want to delete
  2. Click the ⋯ icon
  3. Select “Delete”

This should delete the post straight away on your own server. Most other servers where the post is visible will delete it too, though in some cases there may be a delay in the deletion happening (as the other server may have a queue of tasks to work through).

In a small number of cases a deletion may not happen on the other server, for example if the other server is not working properly. If you’re concerned about how widely a post may be seen, you can restrict its visibility when you post it.

What does “Delete and re-draft” mean?

There are actually two delete options on Mastodon, Delete or Delete and re-draft. The first just deletes the message, but the second deletes the message and sends a copy of it to the post writing box so you can make changes and repost it. However, since the introduction of post editing on Mastodon this second option has been largely obsolete. The only time you would be likely to want to use re-drafting is if you want to change the visibility of a post, as this cannot be done through editing.

Bear in mind that both delete options delete the post, and any shares will be lost, links will break and replies will be orphaned. If you just want to make changes to the content, editing is a much better option.

Can I set old posts to self-delete automatically?

Yes! Click here to see instructions on how to delete posts after a certain time period.

↩ Back to the front page

Recommending accounts to follow for new users on your Mastodon server

When a new user joins your Mastodon server, by default they are shown a list of accounts to follow. This recommendation list is drawn from two different places in the admin settings.

The first place is a manual list of accounts you want to always be recommended, which is always shown at the top of the list.

The other place is an automatic pool of accounts that are randomly recommended to new users. The pool is based on which accounts your existing users are following, but you can edit this pool if you want to remove accounts from it.

Set accounts that your server always recommends to new users:

  1. Log into your server’s website with your admin account
  2. Go to Preferences > Administration > Server Settings > DIscovery > Always recommend these accounts to new users
  3. Paste in the account addresses of the accounts you want to recommend, separated by commas. They can be accounts from your server or from other servers, as long as the account address is written in full.
  4. Click the Save changes button

Edit the random pool of recommended accounts:

  1. Log into your server’s website with your admin account
  2. Go to Moderation > Follow Recommendations
  3. To remove an account from the pool, tick the box next to it and click Suppress follow recommendation
  4. To bring an account back into the pool, click the Suppressed link at the top of the list, then tick the account you want to bring back and click Restore follow recommendation
  5. You can set different recommendation pools for different languages by clicking the For language dropdown menu

↩ Back to the front page

How to add custom emoji to your own Mastodon server

One of the most fun features of running your own Mastodon server is the ability to add custom emoji. All members of your server can use them, and they will be visible in your member’s posts that federate to other servers. You can also clone custom emoji from other servers, or block them if you see something unsuitable.

To access emoji settings, log into your server’s website with your administrator’s account, then go to Preferences > Administration > Custom emoji.

When you first log in, you will see a long list of all the custom emoji visible to your server, including your own and those of all the servers you federate with. To show just your own click the Local tab at the top, to show just those on other servers click Remote.

Adding your own custom emoji

Custom emoji can be PNG or GIF files up to 50kb in size, and can be still or animated. They can also contain transparent backgrounds. (If you want to create your own from scratch, there’s a useful guide by Laura Kalbag here ⧉.)

To add your own custom emoji:

  1. Log in with your admin account on your server’s website
  2. Go to Preferences > Administration > Custom Emojis
  3. Click the Upload button in the top right corner
  4. Add a shortcode, which is a word or words which describes what the emoji looks like. If you use several words, write them as CamelCase or with underscores separating them. Shortcodes are really important as they let blind people hear emoji through screen reader apps.
  5. Browse for the image file and click the Upload button at the bottom

Cloning emoji from other servers

To clone an emoji from another server, tick the box next to it on the custom emoji admin list, and click Copy. If you’re looking for a particular emoji on a long list, use its shortcode in the search box.

Blocking emoji from other servers

To block an emoji from another server, for example if it is offensive, tick the box next to it on the emoji admin list and click Disable or Delete.

↩ Back to the front page

Customising your Mastodon server’s appearance with CSS

You can give your Mastodon server’s website interface a unique appearance by using the Custom CSS feature:

  1. Log into your server’s website using the admin account
  2. Go to Preferences > Administration > Server Settings
  3. Click the Appearance tab and go to the Custom CSS section
  4. Add the CSS code you want in the box, then click Save Changes

If you’re comfortable editing CSS, have a look at this excellent tutorial for customsing a Mastodon server’s colour scheme ⧉.

↩ Back to the front page

What do I call my server? What kind of domain name or subdomain should I use?

When a Fediverse server is created, you have to give it its own name. This can be a domain name (example.com) or subdomain (social.example.com). People can use this server name when signing into their account on an app, or when using the server through a web browser.

The best domain names are usually short, easy to spell and memorable. You may want to avoid offensive words, as they can make it difficult to tell people about your server on other platforms. If you already own a domain, you can use subdomains for your servers.

It’s also probably a good idea to use a name that doesn’t mention the software that it is running. For example, if you were making a Mastodon server you probably shouldn’t mention the word Mastodon in the domain or subdomain. Software projects tend to change over the years, in their content, leadership or maintenance, and it may be that in the future you want to switch to a different kind of software on your server. It could be confusing for your users if your server mentions one kind of software but runs another. Alternatively, software projects sometimes rename themselves, and this too can cause confusion for your server’s users. On top of this, some software projects trademark their names and only let servers use the name if they’re running that specific software. This could make it legally difficult for your server to transition to another kind of software in the future.

↩ Back to the front page

How do I create my own server on Mastodon and the Fediverse?

There are three different ways you can make your own server on the Fediverse:

  • Easiest by far is to use a managed hosting service, where you pay a monthly fee to the hosting company and they do all the technical stuff behind the scenes, including installation, upgrades, maintenance etc. This is so easy that it allows non-technical people to have their own servers. You can find out a lot more about this by visiting my other site Grow Your Own Services, especially the section on growing your own social network ⧉.
  • A medium difficulty option is getting a VPS or home computer and installing special software intended for people who run their own servers, such as YunoHost ⧉, FreedomBox ⧉ or LibreServer ⧉. This requires some technical knowledge, especially to install the software, but after the initial set-up the process the rest is done through a graphical interface and relatively painless.
  • The most difficult option is to install and maintain everything from scratch. This demands the most technical knowledge, but also provides the most flexibility. You can find installation instructions for all Fediverse platforms in their documentation, usually on their official website. For example, Mastodon’s installation instructions are here ⧉.

Some Fediverse server types are available to set up through all three options, others may only be available by manually installing from scratch.

↩ Back to the front page

Mastodon API: Using Mastodon apps with non-Mastodon accounts

Mastodon uses an open API for its servers, which means that anyone can write a Mastodon app and it can make full use of all of Mastodon’s features. This openness means third party Mastodon apps get just as much access to Mastodon’s features as official apps do, and many third party Masto apps are actually better than the official one.

However, a side-effect of this openness is that non-Mastodon Fediverse platforms can also make themselves compatible with the Mastodon API. This means that Mastodon apps will work with those non-Mastodon Fedi platforms too. For example, you can sign in on a Mastodon app using your PixelFed account.

Not every Fedi platform supports this, but many do. The easiest way to find out whether it works is to download a free Mastodon app and try signing in.

(It should be noted that Mastodon’s developers don’t officially support this, and if it stops working you need to check with the maintainers of your Fediverse platform. They probably need to update their software so that it remains compatible with the Masto API.)

↩ Back to the front page

Browsing the Media tab on Mastodon

Screenshot of a profile page on Mastodon with the Media tab highlighted, and various images posted by the account are displayed below it.

On Mastodon, if you’re browsing someone’s profile page you can click the Media tab to just show their posts which have an attached image, audio or video file. Text-only posts and posts shared from other accounts are not shown in the Media tab.

The Media tab is especially useful if you’re browsing for works on an artist’s profile for example, or any account that posts interesting bits of media. It means you can go straight to specific works instead of having to scroll through non-media posts.

Usually the tab is indicated by the word “Media”, but in some apps it may be an icon such a series of pictures.

Does this work on the apps and the website?

There’s a media tab on your server’s website, the web app, the official apps and most of the third party apps. Some of them display a simplified grid of images/video/audio to click on, others just show a timeline of posts that include attached media.

Does the Media tab show boosts of media posts by other people?

No. The Media tab just shows media posts from that account. Shared media from other accounts are not shown in the tab.

Does it show embedded media such as links to other websites?

No, it only shows posts with attached images, audio files or videos. Links that automatically generate a preview of media hosted elsewhere (such as YouTube links) are not counted as media posts.

↩ Back to the front page

Adjusting photo previews on Mastodon so they look nice

If you’re posting a photo on Mastodon through your server’s website, click Edit on the photo before you actually post it. This will allow you to add a text description for blind people, and it will also let you adjust how the photo is cropped in the compact version of the post which is visible in people’s timelines.

Photos that have a 16:9 aspect ratio will not be cropped on the timeline, so you don’t need to adjust them at all (but do still remember to add a text description to keep them accessible!).

↩ Back to the front page

Creating draft posts on Mastodon

Some third party Mastodon apps have a built-in draft posts feature.

There is no official drafts feature in the Mastodon website interface, but unofficially you can use the Delete & re-draft option combined with DMs to create drafts:

  1. Log on through your server’s website and create your draft post, but don’t publish yet.
  2. Set visibility to mentioned people only, and don’t mention anyone.
  3. When you’re ready to save it, publish it.
  4. When you want to edit it, go to your Direct Messages tab and find the draft.
  5. Click the draft open, click ⋯ and select Delete & re-draft, the draft will open in the message editing window
  6. When you’re ready to publish for real, set the visibility to the correct setting and add any mentions you want, then press the Publish button.

…but, as many people have pointed out, it might be easier to just use a notepad app and copy and paste drafts from a text file on your computer or phone 😁

↩ Back to the front page

Why does it say “Pending” or “Cancel Follow” when I try to follow an account?

On the Fediverse, and especially on Mastodon, if you follow an account by clicking the Follow button it then acknowledges this by changing into a “Following” or “Unfollow” button. However, if the follow hasn’t actually happened it turns into a “Pending” or “Cancel Follow” button.

Usually, this means you’ve tried to follow an account that needs manual approval of followers, and you have to wait for the owner to approve your request. You can tell if an account requires approval as it will have a padlock icon 🔒 on its profile next to the username.

They don’t have follow requests switched on, so why does it say they do?

Sometimes this message appears even when the account you’re trying to follow doesn’t have manual approval mode switched on. In this case, the message may be caused by several other things:

  • A software bug which has prevented the follow going through properly. This kind of bug is especially common if you’re trying to follow an account on a new or experimental type of Fediverse server.
  • A server is overwhelmed with stuff it has to do (such as new members signing up), and is struggling to keep up so it puts tasks into a queue to deal with later.
  • The server of the person you’re trying to follow has silenced your server. This restricts communications between the two servers.

What do I do if my follow has turned into a follow request?

If you see that an attempted follow has turned into a follow request but the other account doesn’t have requests switched on, try leaving it for a while as it may just be a temporary glitch.

If that doesn’t help, try cancelling the follow completely, wait for a while and then try clicking follow again, which sometimes helps the follow to go through properly.

If it still doesn’t work, contact your own server admin, and if they can’t help try contacting the admin of the server for the account you’re trying to follow.

Does this message mean someone has blocked me?

No. They probably just have follow requests switched on, and if they don’t then there’s just a technical problem.

↩ Back to the front page

Making your posts visible to a wider audience on Mastodon and the Fediverse

Due to the way the Fediverse currently works, if you publish a post while you still have zero followers, that post will probably not be visible to anyone except people on your server. When people follow you, they will see your posts from that moment onwards, but there’s generally no backfilling to show them your previous posts.

On Mastodon, you can make everyone see past posts by pinning them to your profile. Pinned posts are backfilled and will become visible to anyone who follows you. You can pin up to five posts at once, and they will all be backfilled. Unpinned posts will not be backfilled though.

In general it’s a good idea to wait until you have at least some followers from other servers before you publish your most interesting stuff. Even a handful of followers will give your posts much more visibility across the Fediverse, as you only need one follower from a server to make your posts visible to that entire server.

↩ Back to the front page

Why does someone’s account page look completely blank? Is it really blank?

If a profile looks blank, it may not actually be blank!

Fediverse servers work like this: servers only notice accounts from other servers if someone follows or interacts with them. If no one on your server follows a particular account, and that account is on another server, then that account may appear blank to you.

The reason servers work like this because of resources. If servers had to keep a copy of every post from every user on all the thousands of Fediverse servers in the world, their running costs would become prohibitively expensive (and most of those posts would probably never be read anyway).

The idea of the Fediverse is to let anyone start their own server if they want to, and this process of servers “noticing” accounts helps make that possible.

Viewing the latest and most complete version of an account

To check what the profile really looks like, log in to your account through the website, go to the profile, click on ︙ and then “Open original page”. This should open the profile in a new tab on its home server, which will show all the public posts the account has ever made.

Unfortunately, original pages on other servers are more difficult to interact with. By default your have to enter your username and password each time, though there are ways to make it much easier.

How to prevent your own profile from ever looking blank

If you pin some of your posts to your profile, for various technical reasons your profile will never appear blank to anyone as these posts will always be visible. You can pin up to five posts on a profile, and these can include attached photos, video and audio, so they’re a great way of introducing your account to potential followers from any server. Click here to find out how to pin posts.

Backfilling to the rescue?

There’s there may be a possible solution to blank profiles on the way called “backfilling”. This would mean as soon as you follow someone your server would automatically check the account for past posts and display some or all of them on your server. With backfilling there would be much less need to fiddle around with original pages etc. At time of writing backfilling is the most popular suggestion on the Mastodon github site, and if you’re comfortable using github you can go and give it a thumbs up ⧉.

Update buttons to the rescue?

The official Mastodon roadmap ⧉ has an item labelled “Explicit controls to fetch more data from origin server”, which seems to mean they would introduce some kind of update button to fetch the latest version of a profile on demand. It’s in the “Planned” section of the roadmap which means they’re working on it. These would be practically very similar to the backfilling mentioned above.

Accounts with restricted post visibility

An alternative reason why an active account might look blank is this: if the account has follower requests on (indicated by a padlock 🔒 next to their name), and all its posts are followers-only, then you will not see any posts on their profile until you follow them and your follow request is accepted.

↩ Back to the front page

Why aren’t all Mastodon and Fediverse posts and accounts automatically visible from all servers?

There are tens of thousands of Fediverse servers with millions of users in total, and this amount is growing all the time. There are hundreds of millions of posts going back almost a decade.

It would be horrifically expensive for every independent server to keep a complete, up-to-date record of every post ever made by every user on every other server. The only people who could afford such a system would be megacorporations like Facebook, Google, Twitter etc.

The whole point of the Fediverse is to allow small independent servers to exist as part of a larger network, so that the network is as spread out as possible (click here to find out why this is a good idea). The smallest Fedi server starts from about US$10 a month to run, and this low cost is possible because the server only needs to display posts and shares from people its users follow. Even the largest Fediverse servers are able to operate on a fraction of the budget of a commercial social network because they are only showing posts their users have to see. (If you’re interested, there’s a complete list of what a server can see here.)

Couldn’t Mastodon at least show a few old posts instead of blank profiles?

Having said all of the above, there are definitely ways that the current system of federation could be improved. One feature currently missing from the Fediverse is “backfilling”, where an account’s old posts are automatically loaded to a server when someone on that server follows an account. At the moment you only see posts made by an account after at least one person on your server has followed it, but with backfilling their past posts would become visible too. (Incidentally, Mastodon does already backfill pinned posts.)

The main thing preventing backfilling from being used has been concern about stress on servers, especially if an account has thousands of past posts to backfill. A possible compromise might be letting servers decide for themselves if they will allow backfilling, and how many posts they are willing to backfill. Perhaps smaller servers could allow at least a few posts to be backfilled in order to avoid possible blank profiles.

If you’re comfortable using Github, you can let the developers of Mastodon know you want some kind of backfilling to be possible by giving a thumbs up on the relevant issue ⧉, and if you have your own ideas you can contribute to the thread.

↩ Back to the front page

Which Mastodon and Fediverse posts and accounts can I see from my server?

If you are searching for something on Mastodon and the Fediverse, you will get different search results depending on which server your account is on. This is because each server sees a slightly different view of the Fediverse.

In general, your server can see the following content:

  • All accounts on your server
  • All posts made by accounts on your server
  • All posts shared by at least one account on your server
  • All accounts that at have at least one follower on your server
  • All posts made by accounts that have at least one follower on your server
  • All posts shared by an account that has at least one follower on your server
  • All posts from groups that have at least one follower on your server
  • All posts that have been searched for by their original page’s web address
  • All accounts that have been searched for by their account address
  • All posts pushed to your server by a relay server (if your server uses relays)

How do I make my server notice more posts and accounts?

If a post isn’t visible from your server but you know it exists, you can manually force your server to notice it by copying and pasting the post’s web address from its original page on its home server into the search box on your server. This will make the post appear within your server so you can interact with it and search for it just like any other post.

If you want your server to notice a lot more posts and accounts, ask your server admin if they have considered using a relay service. Modern relay services can be for specific topics, and scripts can be used to backfill missing posts from profiles and conversations.

Why doesn’t my server just notice all posts and accounts from all servers?

Fediverse servers are selective about what they see, because keeping a complete copy of all posts from all other servers regardless of whether they’re needed would be incredibly expensive and wasteful.

The point of Mastodon and the Fediverse is to create a social network where anyone can make their own server, so that the network remains in the ownership of the people and communities that use it. This is possible partly because of the structure, but also partly because the running costs of servers is comparatively low. Fediverse server prices at hosting companies start from about US$8 a month, inculding full tech support that covers all the technical stuff.

If servers had to notice all content from all other servers, they would become incredibly expensive to run, and only megacorporations like Google or Meta/Facebook would have enough money to do so.

Can a server stop noticing posts and accounts?

Yes, if the server’s admin decides to defederate from another server. When a server defederates from another server, it can no longer see posts or accounts from the defederated server.

Alternatively, a server admin may instead decide to suspend a specific account on another server, which will make that account and its posts no longer visible on the admin’s server.

Are there any exceptions to these rules?

If you’re a member of a PeerTube server, it works very differently to most Fediverse servers. When a PeerTube server notices a channel or account from another PeerTube server, it also notices all the videos ever published by that channel or account. This is known as backfilling and at the moment it only happens fully on PeerTube, but there are plans for it to happen more widely.

↩ Back to the front page

Muting conversation threads in Mastodon

On Mastodon, if you have posted in a thread or been tagged in it, but you don’t want to take part any more, you can mute the conversation so that you won’t get notifications from it. No one will know you’ve done this, and it will only affect that thread:

  1. Log in through your server’s website (and some apps also include this feature)
  2. Go to one of your posts in the thread you want to mute
  3. Click ⋯ and select Mute conversation
  4. If you haven’t posted in the thread, go to a post in the thread where you were tagged, then select ⋯ and Mute conversation
  5. If you still can’t find this option, go to your Notifications section, then click ⋯ and Mute conversation on one of the conversation’s posts there

If you change your mind, just do the same thing again but select Unmute conversation.

What if I want notifications about that conversation, but there are just one or two people in the thread who are causing problems?

If the problems in a thread are limited to a small number of people, you might want to try muting their accounts instead. You can mute people indefinitely or temporarily.

↩ Back to the front page

Hiding someone’s boosts in Mastodon without blocking or muting them

On Mastodon, if you follow someone and you want to see their posts but not their boosts, you can hide just their boosts without blocking or muting them. This doesn’t affect their normal posts, and they have no way of knowing you’re doing it.

Log in on your server’s website, and go to the profile of the person whose boosts you want to hide. Click on the ︙ button and select Hide boosts from. If you change your mind, go back to their profile and select Show boosts from.

This only works on accounts you follow.

↩ Back to the front page

How to avoid accidentally unfollowing, boosting or deleting in Mastodon

You can optionally have Mastodon ask you for confirmation when unfollowing someone, boosting a post or deleting a post.

You can switch these confirmations on or off by logging in through your server’s website, then going to Preferences > Confirmation dialogs, tick the boxes for what you want confirmation for, then click Save changes.

↩ Back to the front page

Customising Mastodon polls to allow multiple selections

If you add a poll to your post on Mastodon, by default it only allows people to select one option.

However, if you use your server’s website or the Mastodon web app or certain third party apps, you can customise the poll so that it allows people to vote for several options at once.

Changing poll type on the web interface

If you’re using Mastodon through your server’s website, you can choose a poll type by doing the following:

  1. Log in through your server’s website or through the web app
  2. Write your post and create the poll as normal, but don’t actually publish it yet
  3. Click on one of the circles next to the options, the circles will all change into squares, and the poll will now allow multiple option selection
  4. If you want to go back to single selection, click the squares again and they will change back into circles
  5. When you’re happy with your choice, post the poll

If you change your mind, click on a square to change it back to a circle, which means single option selection.

Changing poll type on apps

The official apps don’t yet support creating multiple poll types, but you can choose poll types on some third party apps.

Third party app interfaces are very varied, but for example Ice Cubes for iPhone/iPad has a menu when you’re creating a poll that lets you choose between “One Vote” or “Multiple Votes”.

⚠️ Editing poll types resets the vote numbers

You can also edit the poll type after you have posted the poll, but this will reset all of the votes to zero (without any warning) when you publish the edit. Also, editing any of the poll texts causes this same reset to zero.

↩ Back to the front page

Why do some people on Mastodon and the Fediverse have bigger character limits?

Most people on the Fediverse are on a standard Mastodon server, which has a 500 character limit for posts and a four option limit for polls. However, sometimes you’ll see people with posts that are much longer than 500 characters. By default Mastodon doesn’t allow admins to adjust character limits, so how is this possible?

There are three ways that someone’s posting limit might be larger than 500 characters:

Method 1: The server admin has customised their server’s software code

There’s nothing in the admin interface of standard Mastodon that allows character limits to be adjusted. However, Mastodon is free open source software and anyone can customise it to suit their own needs. This means admins with the right technical knowledge can adjust the Mastodon code to have a different character limit.

Method 2: The server is running on a fork of Mastodon

There are many pre-customised versions of Mastodon, often with significantly more features for admins and members. Pre-customised versions of open source software are called “forks”. The most popular forks of Mastodon are Glitch ⧉ and Hometown ⧉, which add lots of extra features including the ability for admins to easily adjust their server’s character limit.

Method 3: The server isn’t Mastodon at all, but a totally different type of Fediverse server

Not all of the posts you see on your timelines are from Mastodon. There are many other Fediverse server types that aren’t Mastodon, and these other servers may have much larger character limits for posts. Some like Friendica or WordPress have no limits at all!

What happens if a post is really long? Will standard Mastodon show really long posts?

Standard Mastodon will show long posts but they will be automatically truncated with a Read More link at the bottom, so that timelines remain easy to browse. You can view the full version of a truncated post by clicking on Read More.

Can I ask my server’s admin to increase the character limits?

You can ask them, but bear in mind that standard Mastodon (aka “Vanilla Mastodon”) does not have any options in its admin interface to adjust character limits. The only way they can adjust it is by using one of the unofficial methods listed above, and not all admins can use these options because they may require additional technical skill and/or resources.

Why does standard Mastodon have a 500 character limit? Why won’t they let admins choose the limit more easily?

The lead developer of Mastodon gave the following explanation in 2017 ⧉:

I have denied such patches in the past. If somebody wants to hack it in, they may do so, but I don’t want to encourage it. I feel like (Mastodon’s) UX is designed, visually and behaviourally, around a certain number of characters, and deviations have a negative impact on it. For example, I want people to pick their Mastodon based on, for example, the policies, or the theme, but I want the base level of functionality to be the same so it doesn’t go into the choice.

Of course nothing is set in stone. If you’re comfortable using Github you can give a thumbs up in the relevant issue ⧉.

↩ Back to the front page

How to use Mastodon’s Tweetdeck-style Advanced Web Interface

Screenshot of the Mastodon multicolumn advanced web interface, showing five colums with a posting box, timeline, pinned hashtag searches and various links to features.
Screenshot of the Mastodon multicolumn Advanced Web Interface

By default, Mastodon servers’ websites use a simple single column interface.

However, if you’re using the website through a computer (or a tablet/phone in horizontal mode) there is also an optional multicolumn interface you can use instead. Here’s how to activate it:

  1. Log in through your server’s website as usual
  2. Click ⚙️ Preferences
  3. Tick the box marked Enable Advanced Web Interface and click the Save Changes button
  4. Click the Back to Mastodon link at the left of the screen

If you’re already in multicolumn and you want to go back to the normal single column interface, here’s how to do it:

  1. Click on the ⚙️ cog gear icon
  2. UN-tick the box marked Enable Advanced Web Interface and click the Save Changes button
  3. Click the Back to Mastodon link

If you prefer the normal control method using the mouse, that works fine too.

How to add more columns by using the pin feature

When you first use it, the advanced web interface only contains four columns with one of these columns dedicated to whatever you last selected. Every time you select something, it replaces the contents of this fourth column.

However, if you want to keep a column permanently visible you can pin it, and the pinned column will be added to your previous columns.

  • To pin a column, click on the slider icon in the top right corner of the column and select Pin
  • To unpin a column, click the slider same slider icon and select Unpin

When you pin a column, it expands the interface sideways, and some people have lots of pinned columns. Pinning is well suited to widescreen monitors, and you can scroll the interface sideways to see any columns that don’t fit on the screen.

How to change the order of the columns

You can move a column left or right by clicking the slider icon in its top right corner and then clicking one of the < or > buttons to move the column. These buttons are next to the Unpin option.

What kind of columns can I add?

Any column with a slider icon in the top right can be pinned or un-pinned, which includes hashtag searches, all types of timeline, private mentions (DMs), Lists, Bookmarks, Favourites etc.

Advanced hashtag searches with pinned columns

If you pin a hashtag search and then click the pinned column’s slider icon again, you will see some additional options which let you combine hashtag searches into the same column with special filters:

  • Any means it will show posts that contain one or more of those hashtags
  • All means it will show posts that contain all of those tags
  • None means it will hide posts containing those tags

Pinning accounts as new columns using Lists

You can’t pin an account’s profile page directly, but you can pin particular accounts (or combinations of accounts) as new columns by using Mastodon’s Lists feature:

  1. Click Lists on the Getting Started menu on the right (or click ☰ on the left if you can’t see Getting Started)
  2. Create a new list and add the account(s) you want to that list (see the guide to using lists if you haven’t created one before)
  3. Click the list you want to pin to bring it up as a new column
  4. Click the slider icon in the top right corner
  5. Select Pin

Using Advanced mode through your keyboard

If you prefer using just your keyboard, the Mastodon web interface can optionally be controlled almost entirely through key commands, click here to see the section on hotkeys for a complete list. These hotkeys also include some commands that only work in Advanced mode.

Why are there two official interfaces on Mastodon?

The original website version of Mastodon from 2016 used the multicolumn interface, but while some enjoyed it others found it confusing and overwhelming. Eventually a simpler single column interface was introduced, and single column became the default. The multicolumn interface was renamed “advanced” and made available as an optional mode in settings.

↩ Back to the front page

Why are some accounts marked “Automated” on Mastodon?

If you’re running a Mastodon account that isn’t monitored by a human, it’s considered polite to mark it as an automated account (also known as a bot).

How to add the “Automated” label to an account:

  1. Sign in through your server’s website or web app
  2. Click on your profile image to go to your profile page, then click Edit profile
  3. Scroll down to the box marked This is an automated account, tick the box
  4. Click Save changes

I thought bots were bad? Why is Mastodon encouraging them?

Bad bots are discouraged and blocked, good bots are encouraged and followed.

Good bot accounts can be extremely useful. For example, some bots post sports results or weather alerts, which are exactly the kind of thing people might appreciate seeing in their feeds at any time of day or night. This kind of account would be difficult for a human to maintain 24 hours a day.

Bots can also be entertaining, with some bots running games or posting amusing content.

Can bots interact with people?

Some bots can interact, yes. When there is interaction, it is usually automated, hence the “Automated” label. Vote Chess ⧉ is a nice interactive account, it lets people play chess against a computer by voting for the next move (you can follow it at the address @VoteChess@botsin.space).

Also, sometimes the bot’s human maintainer will post via the bot’s account and reply as well. However, on automated accounts this is rare, and the assumption should be that there is no one monitoring the account.

Where can I find a list of good bots to follow?

Have a look at the Bots category over on Fedi.Directory ⧉.

So why do bots have a bad reputation?

The bad bots you sometimes hear about are where someone has automated an account to do something nasty or anti-social such as posting spam. Bad bots tend to be rare on the Fediverse, and would usually be blocked pretty quickly once the nastiness is reported.

So “Automated” isn’t a bad sign?

If you see an account labelled “Automated”, that is actually the sign of a good bot, because it’s the owner of the bot who chose to label it as such. Another good sign is if the bot’s creator has included a link to their own account on the bot’s profile page.

Bad bots usually try to disguise the fact they are bots, and don’t use the “Automated” label.

↩ Back to the front page

RSS on Mastodon and the Fediverse

RSS feeds are simple, easy-to-use feeds of content from the internet, such as news articles, videos and podcasts. You can use RSS apps to follow Mastodon accounts, and use Mastodon accounts to follow RSS feeds.

What is RSS?

RSS is basically just a special kind of internet address that tells an RSS app where to find content. The apps used to follow RSS feeds are often called “feed readers” or “news readers”.

RSS apps let you make your own custom timelines of all the latest content from your favourite sites, news services, podcasts and other content. All you have to do is enter the RSS address of the site, podcast, news service etc into the RSS app.

How to follow Mastodon accounts from an RSS feed reader app

All Mastodon accounts have an RSS address which can be followed from RSS apps:

  1. Go to a Mastodon account profile’s original page on a web browser.
  2. Copy the web address from the browser’s address bar
  3. Add .rss to the end of the web address to create the account’s RSS address
  4. Add the account’s RSS address to your RSS app

For example, the RSS feed for the FediTips account is https://social.growyourown.services/@FediTips.rss ⧉. Note that this only shows posts with public visibility, you will not see replies or posts with other visibilities.

How to follow RSS feeds from Mastodon

You can also now do this the other way around, and follow RSS feeds from your Mastodon account, thanks to a service called RSS Parrot ⧉:

  1. Create a new post but don’t publish it yet
  2. Mention the RSS Parrot Fediverse account @birb@rss-parrot.net
  3. Mention the RSS address you want to follow
  4. Publish the post
  5. RSS Parrot will create a new Fediverse account that mirrors the contents of the RSS address you provided, and then reply to you with a link to the new account
  6. Follow this new account to follow the RSS feed

This method works for any Fediverse platform that supports microblogging, including Mastodon and many other Fedi platforms.

How to follow PeerTube Channels and Accounts from RSS apps

You can follow any PeerTube accounts or channel through RSS apps:

  1. Go to the channel’s or account’s profile page on PeerTube
  2. Click the channel’s or account’s Subscribe button (if you are logged in on that PeerTube server, click the little arrow on the right of the subscribe button instead)
  3. There will be an RSS subscription option at the bottom of the subscription menu, click this to go to the RSS feed (which may look a bit crazy but don’t worry!)
  4. Copy the address at the top of the browser to get the channel’s or account’s RSS address
  5. Paste the RSS address into your RSS app

This feed will deliver embedded videos to your feed reader and you can watch them there.

Friendica: Champion of RSS

The Fediverse platform Friendica has probably the best RSS support on the Fediverse, including a built-in feed reader which doesn’t need any third party services or apps.

To follow an RSS feed in Friendica:

  1. Paste the RSS address into the search box in Friendica
  2. The RSS feed’s profile page will appear, click Follow
  3. The RSS feed’s contents will start showing up in your main timeline as it is published, and will look like normal account posts

Friendica also lets you turn RSS feeds into Fediverse accounts that people can follow from other Fediverse platforms.

↩ Back to the front page

How to embed Mastodon posts on a website or blog

You can embed posts from Mastodon on your own website, blog or other platform that lets you post HTML code. Here’s how to do it:

  1. Log in through your server’s website or the web app
  2. Go to the post you want to embed
  3. Click ⋯ at the bottom of the post, then select Embed
  4. Copy and paste the HTML code into your website’s page code

What does embedding mean?

Embedding means the post itself will be displayed on the website, and all the post’s interactive elements such as links, images, video, audio etc can be clicked on and will work. For example, news website The Verge embedded a post from Mastodon in this story ⧉.

How do I embed Mastodon posts on WordPress sites and blogs?

If you’re using the block editor in WordPress, don’t use WordPress’s “Embed” block. Instead, use WordPress’s “Custom HTML” block and paste Mastodon’s HTML embedding code there.

Alternatively, if you’re editing the page’s code you can paste the embedding code directly.

How is embedding different from posting a screenshot?

Embedding a post means the post itself is displayed, and any interactive elements such as links, video, audio or images can be clicked on. Screenshots are just pictures of a post and cannot be interacted with.

Some posts don’t have an “Embed” option. How do I embed them?

If a post has a restricted visibility, it cannot be embedded because the creator of the post doesn’t want it to be widely seen. You can only embed posts with a public visibility.

I embedded a post but it doesn’t look like a Mastodon post any more? It uses some other format?

The post you embedded may be from a different type of Fediverse server. Embedding shows the post in the format used on its own server rather than your server.

Timelines on Mastodon servers show posts from all across the Fediverse. Some of these posts are from other Mastodon servers, but some are from different kinds of servers. For the sake of making timelines easy to read, your Mastodon server will display all posts in the same Mastodon format, but that’s not necessarily how they appear on their own server. If you embed a post from a different kind of server, it will look different when you embed it.

↩ Back to the front page

Using Mastodon through a keyboard

If you’re using Mastodon through your server’s website on a computer, you can control it almost entirely through your keyboard. Particular keys will carry out particular functions, and you can type emoji too.

Hotkeys on Mastodon

Hotkeys are always on, press shift + ? (or just ? on some keyboard layouts) to see a complete guide to which keys do what.

Note that some of these keys are only useful in the advanced web interface (multicolumn) mode, but most of them can be used with the default single column mode.

For your convenience, here’s the complete list:

rReply to post
mMention author
pOpen author’s profile
fFavourite post
bBoost post
enter, oOpen post
eOpen media
xShow/hide text behind CW
hShow/hide media
up, kMove up in the list
down, jMove down in the list
1-9Focus column
nFocus compose textarea
alt+nStart a new post
alt+xShow/hide CW field
backspaceNavigate back
sFocus search bar
escUnfocus compose textarea/search
g+hOpen home timeline
g+nOpen notifications column
g+lOpen local timeline
g+tOpen federated timeline
g+dOpen direct messages column
g+sOpen get started column
g+fOpen favourites list
g+pOpen pinned posts list
g+uOpen your profile
g+bOpen blocked users list
g+mOpen muted users list
g+rOpen follow requests list
?Display hotkeys list

Typing emoji through a keyboard on Mastodon

If you’re using Mastodon on a computer, you can type emoji directly with your keyboard.

Just type : (colon) and a keyword without a space. A dropdown menu will appear with the top five matching emoji, and you can pick one with the arrow keys. For example :sun will bring up the top five emoji matching the keyword “sun”.

If there are more than five matches for a keyword, they will not all appear on the dropdown. If so, you’ll need to search for them from the picker icon 😂 in the top right corner of the editing box.

The keywords are based on the alt text of an emoji. If you’re wondering how to search for a particular emoji in future, find it in the picker and then hover your mouse over it. The alt text will appear, and you will be able to use this keyword to bring the emoji up using your keyboard.

↩ Back to the front page

Remote Following on Mastodon: Why does Mastodon keep asking me to log in again and again?

Remote following is where you go to an original page which is not on your own server, and click the Follow or Subscribe button there. By default, it will ask you to sign in again, because it’s asking your own server who you are.

This method is obviously pretty cumbersome, but there are a couple of ways you can avoid having to sign in again:

  • If you have Firefox on a computer you can install the Simplified Federation add-on ⧉ which automatically signs you in when you’re doing a remote follow.
  • If you don’t want to install any extensions but you don’t want to have to sign in again and again, go to your own server’s website or your app, sign into your account as normal, then copy and paste the web address or Fediverse address of the account’s original page into the search box. This will bring up the same account profile but within your own server’s interface, where you can just click Follow. This method avoids having to do remote following at all, and you won’t have to keep signing in. After you’ve done this once, your server will remember the account and you will be able to find it again by just searching within your own server.

Remote following is meant more as a method of last resort, and you’ll find it a lot easier to follow people from other servers within your own server’s interface.

↩ Back to the front page

What are Original Pages on Mastodon and the Fediverse?

Every account and post on the Fediverse has an “original page” on the server that the account or post is hosted on. The original page shows the latest and most complete version of a profile or post. They’re called original pages because they are the original versions of posts and profiles that are federated to other servers.

How do I find a profile or post’s original page?

If you’re using the website or web app:

  1. Log in through your server’s website or the web app
  2. Go to a profile or post and click on ⋯ or ︙
  3. Select Open original page, which will open the original page in a new browser tab

If you’re using an app store app:

  1. Log in through your app
  2. Go to the profile or post and click on ⋯
  3. Select Share, then select the option for opening it in a web browser

Once the page is open, the original page’s web address will be visible in the browser’s address bar at the top.

How to copy original page links for posts more quickly

You can also copy original page links for posts without actually opening them in the browser.

If you’re using the website or web app:

  1. Go to the post
  2. Click ⋯ on the post
  3. Click Copy link to status, this will copy a link to the original page onto your device’s clipboard so you can paste it elsewhere

If you’re using an app store app:

  1. Go to the post
  2. Click ⋯ on the post
  3. Click Share, then select Copy, this will copy a link to the original page onto your device’s clipboard so you can paste it elsewhere.

What’s the point of original pages?

The main reason for looking at the original page is to see the latest and most complete version. However, you can also use original pages to do many useful things, with some examples given below.

Checking if a blank profile really is blank

If no one on your server has interacted with a profile before, it may appear blank. You can open the profile’s original page to check if it really is blank.

Browsing a profile’s followers and follows lists

Sometimes a profile’s follows and followers may not be visible to your server, or it may be incomplete. If you go to the original page and click on the follows and follower lists there, you will see their complete versions. (However, note that some people deliberately keep their follows and followers lists hidden for privacy reasons.)

Using original page addresses to interact with posts and profiles

If there’s a profile or post that you can’t find by searching on your server, but it does show up in results on search engines such as Duckduckgo, Google etc, you can use these pages to force your server to notice people and posts it hadn’t noticed before, including pages from other types of Fediverse server. Just copy and paste the page’s web address into the search box on Mastodon, and it will make that post or profile appear within your own server where you will be able to interact with it directly.

Not just Mastodon, there are original pages on all kinds of Fediverse servers

Original pages aren’t just on Mastodon, they work with any Fediverse server type. For example if you know the web address of a PeerTube video or Pixelfed photo, you can paste it into the search box on Mastodon and the video or photo will appear within Mastodon. You will then be able to interact with it as if it was a Mastodon post.

The process of copying and pasting web addresses works in a very similar way to account addresses.

Sharing Fediverse content with people outside the Fediverse

Original pages are really useful if you want to share a profile or post with people outside the Fediverse, as you don’t have to be logged in to see them. Just give people the original page’s web address and it will open in any browser, they don’t have to log in or be a member.

Why doesn’t Mastodon just show original pages everywhere, instead of sometimes showing incomplete ones?

Click here for more discussion about this, including why it happens and what might be done about it.

↩ Back to the front page

Crossposting between Mastodon and Twitter

You can automatically crosspost between Mastodon and Twitter in either direction using third party services. Crossposting means when you post on Mastodon the same content will also be posted on Twitter (or vice versa).

This can be controversial if you’re just mirroring your Twitter account to Mastodon without interacting on Mastodon at all. Some servers specifically ban such “zombie accounts”.

Going in the other direction, if you’re active on Mastodon and mirroring it to Twitter, there’s no controversy at all.

Which crossposting services are available?

Professional paid crossposting services such as Buffer ⧉ and Publer ⧉ are still working.

However, most free crossposting services have shut down due to Elon Musk’s shutdown of Twitter’s free API.

↩ Back to the front page

Customising your notifications on Mastodon

On Mastodon, you can customise your notifications to adjust what triggers a notification to appear and what kind of notification it provides. The notification options you have depend on what you are using to access Mastodon:

  • On your server’s website, go to your Notifications column and click on the slider icon in the top right corner to open the notification settings. Note that there are even more options available if you scroll this settings menu down a bit.
  • On the official app, go to the main timeline and click on the cog icon ⚙️ in the top right corner, then click on Notifications.
  • Third party apps will have various different interfaces for customising notifications, but they’ll usually be in their settings sections.

Different ways of accessing Mastodon will give you different options for customising notifications, for example the website lets you adjust which notifications cause a sound.

What about email notifications?

Email notifications on Mastodon are a totally separate system that happens to have a similar name. To adjust your email notifications:

  1. Log in through your server’s website
  2. Click ⚙️ Preferences
  3. If you’re on the desktop website, click Notifications on the left of the screen. If you’re on the mobile website click ☰ in the top right and then Notifications.
  4. Choose your email notification settings. If you don’t want to receive any emails, untick all the boxes.
  5. Click the Save Changes button in the top right corner of the screen

↩ Back to the front page

I’ve written a link but it isn’t clickable, how do I make it clickable? What kind of links can I use on Mastodon?

If you want a clickable website link within a post or on a profile on Mastodon, remember to include https:// at the beginning when you’re writing it. This tells the server that you want the link to be clickable.

Twitter automatically changes anything with a dot in the middle into a clickable link, but this doesn’t happen on the Fediverse because some people want to include dots without making clickable links.

As well as website links, you can also use many other kinds of links. All of these will work as clickable links on Mastodon: https://, http://, gemini://, dat://, dweb://, gopher://, ipfs:// and ssb://

↩ Back to the front page

Choosing a good username on Mastodon and the Fediverse

Fediverse addresses have two parts, the username and the server name.

By default, Mastodon and most other Fedi server types hide the server part of the address within posts so that they are easier to read. All you will see in conversations is the first part of the address, so you would see @john even if the full address is @john@example.com. (This is similar to how real life conversations often just use a person’s first name.)

This means that it’s a good idea to choose something distinctive for a username, because in posts people will often just see the username on its own.

I’m not sure what you mean. Could you give some examples?

An account with the address @MarvellousWidgets@example.com, would look like @MarvellousWidgets in conversations. People can refer to it in discussions and it’s still clear who is being talked about: “Have you seen the latest release from @MarvellousWidgets?”

If it had a more generic username such as @software@example.com, all that people would see of its address in posts would be @software, and it’s not clear who is being talked about. A discussion using it would look like this: “Have you seen the latest release from @software?”. People would have to click on the username each time to find out who they are, because so many other accounts have a similar username.

I have my own server with a custom domain. That makes my address distinctive, right?

Yes and no. The full address with a custom domain is indeed very distinctive, but because the domain is hidden by default in discussions, it is still important to choose a distinctive username, as this is what most people see most of the time.

Don’t use dots / full stops / periods in usernames

Some Fediverse server types allow you to use . in usernames while others (including Mastodon) don’t allow it. People will not be able to follow you from Mastodon if you use a . in your username, so it’s safest just to avoid using . in usernames.

Don’t use really short usernames

If your username is very short, it is physically more difficult for people to click on it or tap it. Try to use at least four or five letters, preferably more.

What happens if two accounts with the same username are mentioned in the same post?

Mastodon etc will automatically show accounts’ full account addresses if two accounts with the same username are mentioned in the same post. This is also similar to real life conversations: if you were talking about two people called John in the same conversation, you might mention their surnames so that people know which John you’re referring to.

Why doesn’t Mastodon just show everyone’s full account addresses within posts?

Account addresses can be very long, depending on the domain name used by the account’s server. It can be quite hard to read a post where full addresses are used all the time. Just showing the username makes posts a lot more readable.

How do I find out the full account address of a username?

Just click on the username, that will take you to the user’s profile page which includes their full and unique account address.

↩ Back to the front page

How to use the Lists feature on Mastodon

The “Lists” feature lets you create mini-timelines that show posts from selected accounts you already follow. You can also optionally hide listed accounts’ posts from your main timeline, and just browse them on the lists.

Why would I want to make a List?

If your main timeline is getting a bit crowded from following so many people, you can add accounts to Lists and then hide them from your main timeline (see instructions further down the page).

Alternatively you might just prefer having themed Lists to browse. For example, you could create a List which just shows posts from artists you follow, or just news accounts, or whatever kind of theme you want.

Okay, so how do I actually make a List on Mastodon?

You can create and use Lists on your server’s website, on the Mastodon web app and on some third party Mastodon apps such as Tusky for Android or Mona ⧉ for iPhone/iPad.

To create a list through the web version of Mastodon:

  1. Open your profile page, then click on the section marked Following.
  2. Browse through the accounts you follow. When you find an account you want to add to a list, click on their name to open their profile page.
  3. On the profile of the person you want to add, click on the ︙ symbol and select Add or remove from lists. This will cause the Lists editor to open.
  4. Create a new list by typing a name for the list into the white box (you can skip this step if you’ve already created a suitable list).
  5. Click the + sign next to the list you want to add the account to.
  6. Click anywhere outside the Lists editor box to close the editor.
  7. You can browse Lists by clicking the Lists icon on the right of the screen (three horizontal lines with three dots). If you’re using the website through a computer, direct links to lists will also be visible on the right side of the screen.
  8. Don’t worry if a list looks empty. Lists always start out empty as they don’t show posts from before the list was created, but you will start seeing new posts appear on the list over time.
  9. To edit or delete an existing list, click on the list’s name to open it and then click on the slider icon in the top right corner of the list. This editor also includes a search box for searching accounts you follow, if you prefer to add accounts to your list that way.

…and that’s it! You can add more accounts to lists by repeating these steps.

By the way, third party apps may have slightly different interfaces for lists, but it’s the same feature.

You can also add accounts to Lists (though you can’t create new Lists) on the official Mastodon Android app. Go to the profile of an account you want to add to your list, click ︙in the top right corner and then Add to list…

Can I view accounts on Lists without them appearing on my Home timeline?

Yes! You can hide posts by accounts on your lists Home timeline:

  1. Log in through your server’s website
  2. Go to the Lists section
  3. Click on the list you want to hide on Home
  4. Click on the slider icon in the top right corner
  5. Select Hide these posts from home

This means you can have lists that are entirely separate from your Home timeline.

Why do I have to follow accounts that I add to Lists?

The following requirement is for the sake of safety and privacy. On some social networks such as Twitter, List-style features have been misused by trolls and bullies to make lists of potential victims.

On Mastodon, the follow requirement gives people more control over being listed. If an account has follow requests activated, it lets them control whose Lists they may end up on, and if an account blocks someone that also prevents them being added to that person’s Lists.

Do boosts show up on Lists?

Yes, you see everything you would see from that account on your Home timeline.

Can I follow hashtags on Lists?

No, not at the moment. However, this is a very popular suggestion and if you’re comfortable using Github you can vote for this option by giving a thumbs up on the relevant issue ⧉.

How many Lists can I create?

As many as you want.

Can I share Lists with other people?

No, they’re just for your personal use.

What do all the options mean on the Lists feature?

Edit list – Lets you change the list’s name and add or remove accounts from the list

Delete list – Deletes the list

Hide these posts from home – With this option switched on, posts that appear on your lists will not appear in your Home timeline

Show replies to no one – You will not see any replies in your list, only new posts by the accounts on the list

Show replies to members of the list – You will only see replies by accounts on the list to other accounts on the list, and new posts by accounts on the list

Show replies to any followed user – You will see replies by accounts on the list to accounts that you follow, and new posts by accounts on the list

If I move my account to another server, can my Lists come with me?

Yes. Lists are now available to export and import as part of the account transfer process.

↩ Back to the front page

Using multiple accounts on Mastodon and the Fediverse

First of all, it’s worth saying that most people do not need multiple accounts. The Fediverse is designed in such a way that people on different servers can interact seamlessly, as if they were all on one network. For most people one account is enough, because it lets you interact with people on the whole network. However, there are situations where having more than one account is useful.

So, why have multiple accounts?

Lots of possible reasons:

What are “alt accounts” or “alts”?

“Alt accounts” or “alts” just mean alternative accounts owned by the same person. They may be permanent or temporary.

Can I be signed into several accounts at once?

Yes, all the official and third party apps support being logged into multiple accounts simultaneously, and you can also be signed into several accounts at once on the web browser and web apps.

Apps normally have an account switching button in the corner of the screen which you can press to select which account you want to use. Alternatively, you can use several different apps if you prefer. The official Mastodon apps have a switcher in the bottom right corner of the screen, hold it down to add an account or switch between accounts.

If you’re using accounts through the web browser and your accounts are on different servers, you can be signed into multiple servers at once and switch between them by keeping each one open in a separate tab. You can use the same email address when signing up for accounts on different servers.

Should I sign up for multiple accounts on the same server or different servers?

If you’re going to have multiple accounts, it’s highly recommended that you sign up on different servers. Having accounts on separate servers brings significant advantages:

  • If a server breaks down, accounts on other servers will still work. It is extremely unlikely that several servers would break down at exactly the same time, so if you have multiple accounts you will always have at least one working account.
  • Web browser and web app users can be signed into all of their accounts at once if they are on separate servers.
  • By having accounts on different servers, you can use the same email address for all of them.

It’s the independence of each server that makes it good to have accounts on separate servers. It means any kind of problem that hits one server will not affect your other accounts.

Can I sign up for multiple accounts on the same server if I want to?

Yes, you can, but it will be putting all your eggs in one basket. If that server goes down, it means you lose all access to the Fediverse. It also makes it more difficult to log in on web browsers and web apps, as you will probably have to keep signing in and out.

How should I promote my other accounts?

A common way to promote your other accounts is to mention them in your account profile page. It’s also highly recommended that you follow your other accounts, so that their content will federate more widely.

↩ Back to the front page

How can Mastodon server administrators automatically remind their users to add text descriptions?

If you run a Mastodon server, you can add a special chunk of custom CSS to your server which causes image posts without descriptions to have a red border.

To do this, go to Preferences > Administration > Site Settings > Custom CSS and then add the code from here ⧉.

↩ Back to the front page

How do I add a text description through Mastodon’s edit feature?

There used to be a bug in the edit feature which prevented descriptions being edited. However, the bug was fixed in Mastodon version 4.1.0, so as long as your server is running 4.1.0 or higher then you should be able to edit descriptions just like you would edit the rest of the post.

You can see which version your server is running by going to your server’s website and looking at the bottom of the screen. If you’re on a phone browser, you may need to tap the ⋯ icon and then scroll to the bottom of the screen.

If your server is still running an older version of Mastodon, there is a workaround which does let you add descriptions through editing:

  1. Edit the post
  2. Delete the image
  3. Re-upload the same image
  4. Add the text description
  5. Save changes to the post

↩ Back to the front page

How do I remember to add text descriptions on Mastodon and the Fediverse?

If you’re not used to adding text descriptions, it’s unfortunately quite easy to forget. However, help is available! If you follow the Please Caption bot at @PleaseCaption@botsin.space ⧉, it will automatically tell you if you’ve forgotten to add a text description.

Text descriptions are expected on the Fediverse, it’s seen as good manners to be considerate of screen reader users. By the time you’ve been doing it for a while, it becomes second nature.

↩ Back to the front page

How do I make posts more accessible to blind people on Mastodon and the Fediverse?

There are a lot of people on Mastodon and the Fediverse who use screen readers to convert text into audio, including blind people, partially sighted people and those with many other disabilities. There are five easy things abled people can do to help screen readers work better with what they’ve posted:

  • When posting an image or video, click on the “edit” or “caption” button (or write directly on top of the image on some apps) and then add a text description of what is visible. Read it to yourself afterwards, and see if you are able to imagine the important parts of the picture from what you have written. When you’ve finished, remember to click the “Apply” button if if necessary.
  • When posting hashtags, use CamelCase (where each word begins with a capital letter), for example #DogsOfMastodon instead of #dogsofmastodon. The capital letters allow screen reader apps to separate the words correctly and read the hashtag out loud properly.
  • Don’t do that “sarcastic text” thing where you make fun of someone by having random letters as capitals, because random capitals prevent a screen reader from working properly.
  • If you’re sighted and you see the hashtag #Alt4Me underneath an image post, it means a blind person wants you to write a description of the image. Reply to the post with the tag and give them the description.
  • Also, if you’re a sighted person and you see a remarkable image that doesn’t have a descrption and no one has requested one yet, be pro-active and reply with a description using the tag #Alt4You which will let blind people find your description more easily.

Note that sometimes an image may have no description but there is an #Alt4Me tag added to it by the poster. It may be that the poster is unable to add a description (for example due to having a disability themselves), but is aware that one is needed so they have pre-emptively added the tag.

Should I be criticising people who haven’t added alt text?

It’s important to add descriptions to images so that they’re accessible, but it’s also important not to criticise those who are unable to add alt texts due to their own disability. If someone has written #Alt4Me alongside the image that means they cannot add descriptions themselves. Don’t criticise them or comment on the lack of description, just help them out by replying with an #Alt4You post which includes your own alt text for the image.

If there’s no #Alt4Me tag on the undescribed image, it’s still worth being polite as no one wants bad feelings generated around the topic of descriptions. You might want to just reply with a description and #Alt4You tag, and if they’re abled they will hopefully get the message that descriptions are preferred.

↩ Back to the front page

How do I use Mastodon through a screen reader?

Mastodon can be used through screen reader software that converts the text into audio. Here are some useful guides written by blind Mastodon users:

↩ Back to the front page

Creating an isolated Mastodon server

Mastodon servers don’t have to communicate with other servers. They can be run in “Limited Federation” mode, where all other servers are blocked by default. This can be left as it is for a totally isolated community, or an “allowlist” can be introduced which allows specifically selected servers to communicate.

If you want to do this with Mastodon, there’s a web page with instructions and tips on Limited Federation mode here ⧉ and there’s a technical description of Limited Federation mode ⧉ in the official documentation.

Allowlists vs Blocklists: How do they differ?

In normal mode, Mastodon servers can communicate with other servers unless the server admin blocks them. This is known as a “blocklist” system, because it depends on the admin telling their server which other servers to block.

In Limited Federation mode, it’s the opposite way around. No servers can communicate with the server unless the server admin specifically allows them. This is known as an “allowlist” system, because it depends on the admin telling their server which other servers to allow connections with.

How do I set my server to Limited Federation mode?

You’ll need to be a server admin to change your server’s federation.

If the server is on a managed hosting company, the admin will need to ask the hosting company to switch the server over to Limited Federation mode.

If the server has been set up manually by the admin, they will need to make the adjustments manually by consulting the official Mastodon documentation on federation ⧉.

Will the apps work with a server in Limited Federation mode?

The server’s website and the web apps should work fine.

There may be problems with some app store apps working with servers in Limited Federation mode. You might want to have a look at the guide linked to above ⧉ for more info on which apps work.

↩ Back to the front page

Adding user safety through Authorized Fetch on Mastodon

This is a bit technical, but there’s a little-known feature on Mastodon called “Authorized Fetch”, aka “Secure Mode”. By default it is switched off as it uses more resources and can cause compatibility problems with servers running older software.

When it is switched on, it makes all blocks more effective, including both server-level and user-level blocks. This empowers users to fight abusers and trolls more effectively, and makes the server’s own blocks more powerful too.

Which kind of posts does this affect? Can abusers see followers-only or mentions-only posts?

Posts using follower-only or mentions-only visibilities are already protected from unauthorised interaction. Authorized Fetch only makes a difference on public or unlisted posts. If you never use public or unlisted posts, you don’t need Authorized Fetch.

Please see the post visibility guide for all the kinds of visibilities that a post can be, and how to set your defaults.

I am a server admin, how do I find out more about this?

There’s an official technical description of Authorized Fetch here ⧉ and a detailed unofficial article here ⧉ which might be useful.

How to activate Authorized Fetch on Mastodon

Only server admins can activate it, so if you’re not an admin you’ll need to contact your server’s admin and ask them to do this.

The latest version of Mastodon includes controls in the graphical interface for activating it:

  1. The admin should sign onto the Mastodon server’s website or web app using their admin account
  2. Click ⚙️ Preferences
  3. Click Administration (on the left of the screen or in ☰ on the mobile site)
  4. Click Server Settings
  5. Click the Discovery tab at the top
  6. Tick the box marked Require authentication from federated servers
  7. Click Save changes

On some managed hosting services this option may be greyed out. If so, ask the managed hosting company to switch it on for you.

Why isn’t this on by default?

Authorized Fetch uses more server resources as the server has to do a lot more checks for each post to prevent unauthorised interactions.

However, the costs of these extra resources may be worth it for the extra level of user safety the feature brings.

Does this stop website scraping?

No, nothing can stop scraping of public posts on a public website. However, scraping a website and copying its contents is not the same thing as interacting directly with a thread on a social network.

Compatibility with other Fediverse servers

Authorized Fetch is an official feature of Mastodon and it should work fine when federating with servers that are running Mastodon 3.0.0 or higher. It should also work with GoToSocial (which uses Authorized Fetch by default), Pixelfed, PeerTube and most other Fediverse server types.

↩ Back to the front page

Is Mastodon end-to-end encrypted?

No. Mastodon isn’t E2EE. Some work has been done ⧉ on building an encrypted messaging system into Mastodon, but it isn’t finished yet.

What does this mean? Can my server’s admin read my DMs?

In theory, the owner of your server could read at your DMs in the server’s database. However, it’s not as simple as that in practice.

An admin would need a certain level of technical skill, as there is no way to view DMs in Mastodon’s admin interface. The server owner would have to manually look through their server’s database directly to read a DM, and bypass Mastodon’s admin interface completely. It’s not something they could do casually.

Is this normal?

Social networks typically don’t encrypt messages by default. For example, on Twitter/X all DMs and posts are visible to moderators.

Can everyone see my DMs on Mastodon?

No, they would need direct access to your server’s database, which is restricted to the server owner and their hosting provider.

What should I use if I want to send sensitive information?

If you want to send something sensitive, the best option is to use a dedicated messaging system with end-to-end encryption.

There’s a very popular encrypted messaging system called XMPP (also known as Jabber). XMPP is structured like Mastodon, with lots of connected servers, but it is designed entirely for private messaging and calling. There’s a website to help non-technical people sign up on existing servers at JoinJabber.org ⧉ and there’s a managed hosting service to help non-technical people set up their own server at Snikket.org ⧉.

Is XMPP compatible with Mastodon? Is it part of the Fediverse?

No. XMPP is designed entirely for messaging, calling and real time chatting. It isn’t intended as a social network, and doesn’t use Fediverse protocols like ActivityPub. However, the server structure of XMPP is very similar to Mastodon and has the same advantages, which is why it’s recommended on this website.

Some Fediverse server admins also run XMPP servers too. If you’re happy with how your Fediverse server is run, it might be worth asking your server admin if they have an XMPP server too.

How do I make sure XMPP is encrypted?

Modern XMPP apps use a standard called OMEMO for end-to-end encryption. As long as everyone taking part in a conversation has the OMEMO feature switched on, then the conversation will be encrypted. If you’re unsure, you should be able to find OMEMO in your XMPP app’s settings page, and you can check which XMPP apps have OMEMO-compatibility at the Are we OMEMO yet? ⧉ website.

XMPP? Jabber? Which is it?

XMPP and Jabber are the same thing. “Jabber” was the original name, but unfortunately a commercial company bought the trademark for it. A new name was required and it was decided to use “XMPP” officially, though unofficially many people still call it Jabber as it’s easier to remember.

Who controls XMPP?

No one controls it, it’s decentralised and federated. The XMPP network is made up of many indpendent servers that talk to each other.

XMPP is a free open standard maintained by the non-profit XMPP Standards Foundation ⧉. Anyone can use the XMPP standard on their server or app, and each server and app is totally independent.

↩ Back to the front page

Using Two Factor Authentication (2FA) on Mastodon

To keep your Mastodon account extra secure, you can use a feature called “Two Factor Authentication”, also known as “2FA”. When you have 2FA activated, even if someone finds out your password they still cannot log into your account.

How does 2FA work?

2FA usually works through a special app on your phone, tablet or computer which constantly generates special pass codes, often in the form of six random numbers. These codes are linked to your account, and only your app will generate codes that match your account.

When you want to log into your account, as well as your password Mastodon will also ask you for your 2FA code, which you can find out from your app. It will then log you in.

How do I get a 2FA app?

There are many 2FA apps in all app stores, for example Aegis and Raivo are popular 2FA apps. Apple’s keychain also includes 2FA support. The technical name for these apps is “TOTP” or “Authenticator”.

I’ve got my 2FA app, how do I activate 2FA on Mastodon?

  1. Log into your account on your server’s website or on the web app
  2. Click ⚙️ Preferences
  3. Click Account (on the mobile site click ☰ and then Account)
  4. Click Two Factor Auth (on the mobile site click ☰ again and then Two Factor Auth)
  5. Follow the instructions, including the part about keeping the backup codes in a safe place

After you’ve activated 2FA, the next time you log in on Mastodon it will ask your password and then ask your 2FA code. Go to the app and find the code, then type this into Mastodon.

Do I need to type a 2FA code in every time I use Mastodon?

No. You only need to use a 2FA code when you log in, so if you stay logged in it won’t ask for the 2FA code.

What if someone sees my current 2FA code?

It doesn’t matter, because the current 2FA code changes so frequently. Most people set it to change every few minutes or even every 30 seconds. If someone sees your current 2FA code, it will soon change to something else anyway and the old code will be useless to them.

The only code you need to keep secret is the 2FA’s backup code, which you should print out and put in a safe place. This backup code gives you access to your account if the 2FA app stops working for some reason.

Is 2FA just for techy people, or can non-techy people use 2FA as well?

Setting up 2FA is slightly tricky, and it will require you to keep a permanent copy of a special code in a safe place, preferably printed out and kept at home with your other important documents. This special code lets you access your account if you lose access to your 2FA app. If you’re not technically minded, you might want to get help from a trusted friend or relative in setting it up. Make sure they are people you trust, as the backup code would allow them access to your account.

However, after it has been set up, 2FA is extremely easy to use: the 2FA app displays a code and you simply type this in when Mastodon asks you to. It’s very simple and becomes second nature quickly.

Does the 2FA app know what I’m doing?

No. 2FA apps have no awareness of anything you’re doing.

The apps just passively display a list of security codes generated from the current time and your unique account keys. It doesn’t send any data anywhere, the code generation happens entirely offline on your own phone or computer. The apps have no idea if you’re even using the codes.

At a technical level, 2FA apps are essentially just very elaborate clocks, but instead of displaying the time they display ever-changing access codes. Your account’s server also knows what time it is, and that’s how it knows whether your 2FA access code matches up with what it should be.

Is 2FA just for Mastodon, or can I use it for other things?

It’s not just Mastodon! Most major online services nowadays have an option to activate 2FA. For example most email providers include 2FA support, and using it works just like logging in on Mastodon.

You can use the same app to generate all your codes. Each service uses a different code, and your app will generate a list of different codes if you use it on many services.

↩ Back to the front page

How to prevent your account being suggested to others in Mastodon

On Mastodon, there’s a feature that automatically suggests accounts to follow when people first join a server, and when they click on the For You tab in Explore or Search. It is based on how many people on that server follow the account and boost its posts, and server admins can optionally add suggestions manually too.

If you don’t want your account suggested to others:

  1. log in through your server’s website
  2. Go to Edit Profile > Suggest account to others
  3. Make sure the box is unticked and click Save changes. (If you want your account suggested, tick the box and save instead.)

↩ Back to the front page

Filtering your Mastodon timeline to automatically hide posts containing certain words, phrases, hashtags, links or emoji

On Mastodon, you can set your timeline to automatically hide or block posts featuring certain words, phrases, hashtags or emoji. You can choose to block them completely, or hide them behind a warning that you can open manually.

This isn’t just about offensive posts, it can be filtering for any reason at all. Some people use filters to hide Wordle posts for example. Your filters are private, and they will apply in the apps as well as on the website. No one will know you have filtered their posts.

To add a filter:

  1. Log in through your server’s website or the web app
  2. Go to ⚙️ Preferences > Filters (On the mobile website click ⚙️ and then ☰ and then Filters, on the desktop website click ⚙️ Preferences and then the Filters link on the left side of the Preferences page)
  3. Click the Add new filter button
  4. Choose the settings you want, then click Save new filter

Some tips which might help with creating filters:

  • The Title section at the start of a filter is just a name you want to give the filter so you remember what it does. It isn’t the actual words the filter uses.
  • You can add the filtered words, phrases or emoji in the Keywords section at the bottom. They aren’t case sensitive.
  • The filter will look for these keywords in entire posts, including the actual content, hashtags, account addresses, alt text descriptions or web addresses mentioned in posts.
  • Filters work retrospectively, so posts made before the filter was created will also be filtered.
  • You can add more words and phrases to the same filter by clicking the + Add keyword link at the bottom of the page. The filter will be triggered if any of the words or phrases are present.
  • You don’t need to include # on filtered hashtags, these will automatically be blocked if they contain a filter’s keyword.
  • You can make filters temporary by setting the Expire after section. By default this is set to “never” which means the filter is permanent.
  • The Filter contexts section lets you apply the filter to specific parts of Mastodon. If you want it applied everywhere, tick all the boxes.
  • If you have the Whole word option on the filter ticked, it means the filter only applies to posts containing exactly that word. If you UN-tick this option, the filter will also apply to posts that have that word with other letters or numbers next to it without spaces, for example within another word, or a different form of the same word.
  • You can edit or delete filters at any time by going back to the Filters section in ⚙️ Preferences.

How do I filter posts that contain a particular link?

Add a filter for part of the text in the link (such as the link’s domain name), then make sure you have UN-ticked the box marked Whole word, then save the filter. This will filter anything that contains that text including links.

↩ Back to the front page

How to use Content Warnings (CWs) on Mastodon and the Fediverse

Content Warnings (CWs) are an optional Fediverse feature which hides the content of a post behind a warning message. The post can be revealed by clicking on the warning. Only the person who writes the post can add a CW to it.

What are CWs for?

Content warnings hide any kind of content where the person reading may not want to read it right that minute, but they may want to read later. It could be something serious like upsetting news, or less serious like film spoilers. There’s also a very strong Fediverse tradition that those who are able to should use CWs when talking about emotive topics such as politics or religion. It is also often used for potentially “not safe for work” content such as gore or nudity.

How do I add a CW to my post?

  1. Start writing a new post or edit an existing post
  2. Click on the button at the bottom of the message writing window labelled “CW” or “Warning” or ⚠️ or other similar icons
  3. Write a brief warning giving people a clear idea of what to expect within the post itself, without them having to actually open it
  4. Publish the post

What if I want to open lots of CWs at once?

On Mastodon, if you are using the website or the web app you can make all the CWs in a thread open or close at once by clicking the 👁️ eye icon in the top right corner of a thread. (Note that the eye icon on the official app does something different.)

I don’t care about warnings, how do I make all posts be visible automatically?

If you don’t want to ever see any CWs at all, you can make Mastodon open all CW posts by default:

  1. Log in through the website or the web app
  2. Click ⚙️ Preferences
  3. Scroll down the page and tick the box marked Always expand posts marked with content warnings
  4. Click the Save changes button

Is it compulsory to use CWs?

It depends.

Some servers have specific rules about when to use CWs, while others ask you to use your initiative.

When exactly should I use CWs? What if I see someone not using CWs when they should be?

CWs are an accessibility feature for many people, as they allow those who have traumas triggered by certain topics to read potentially triggering posts when they are mentally prepared to do so. It’s important to emphasise the point that for many people CWs are not about avoiding topics, it’s exactly the opposite: CWs make triggering posts accessible to people who would otherwise have to avoid them, in the same way that text descriptions make images accessible to blind people. They can widen your post’s audience.

Having said that, it is a bad idea to call people out for not using CWs! Some people will have legitimate reasons for not using CWs, for example someone who is currently going through a serious personal trauma, or perhaps is being persecuted or under threat of violence. It is not appropriate to demand CWs from someone who is going through something really horrific in their real world life. They may have much bigger things to worry about than social media, and we should help them deal with these bigger things however we can.

Even if someone should be using CWs, having public arguments about rules is not necessarily the best way to get someone to obey them, especially if they’re new to the Fediverse.

If there’s a post you think should be CWed and there’s no obvious reason why it isn’t, check the rules on your server and then ask your server admin for advice on what to do. They set the rules, and they are ultimately the ones that decide what is allowed on there.

In short, CWs are a balancing act, and require a lot of social skill (that’s why this section is so long!). The existence of CWs brings the Fediverse a tiny bit closer to the complexities of everyday life in the real world, where reading the room is essential to getting on with people. No one is going to get this right all the time, but simply being aware of CWs as an option and using them when you feel appropriate and able will make the Fediverse a much more accessible and pleasant place to be.

How do I add a CW to a post I want to share?

You can’t add CWs to someone else’s post. The reason for this is such a feature could be mis-used to quote the post, which is deliberately not available on Mastodon.

A workaround is to do a reply to the post with a CW telling people to read the post above, and then share your reply.

↩ Back to the front page

Hiding your posts from search engines on Mastodon and the Fediverse

If you use a public visibility setting on a post, it will be visible to everyone, even people who aren’t Fediverse members. This means the post may be indexed by search engines.

You can either make your posts invisible to search engines, or ask search engines not to index your public posts.

Prevent a post being visible to search engines

The surest and safest way to prevent a post ending up on a search engine’s index is to use a non-public visibility setting. Followers-only and Mentioned settings cannot be seen by search engines, so they will not be indexed.

Ask search engines not to index your posts

Mastodon also has an option to request that search engines don’t index your public posts:

  1. Log in through your server’s website
  2. Go to Preferences > Other > Opt out of search engine indexing
  3. Tick the box and click Save changes

However, bear in mind it’s up to a search engine to decide if it wants to honour this request, and less honest search engines may decide to ignore your request. If you want a post to remain off search engines, it’s much safer to use a non-public setting.

↩ Back to the front page

How to hide your follows and followers in Mastodon

If you’re on a Mastodon server, you can keep your lists of follows and followers hidden on your profile if you want to:

  1. Log in through your server’s website
  2. Click on Edit profile if you’re on the desktop website. If you’re on the mobile website click on your profile icon in the top right corner, then Edit profile.
  3. Click on the Privacy & Reach tab
  4. Scroll down to the Show follows and followers on profile option and make sure it is un-ticked
  5. Click the Save changes button

You will still be able to see your follows and follower lists when you look at your profile while logged in, but other people will not be able to see them.

If you change your mind, repeat the process above but tick the box instead.

↩ Back to the front page

Restricting who can follow you on Mastodon

On Mastodon, you can use a follow request system to restrict who can follow you. When it’s switched on, no one can follow you unless you manually approve their request. This can be used to screen who follows you.

To switch on the follow requests system:

  1. Log in through your server’s website or through the Mastodon web app
  2. Click on your profile image to go to your profile page
  3. Click on Edit profile
  4. Click on the Privacy and reach tab
  5. UN-tick the box marked Automatically accept new followers
  6. Click the Save changes button at the bottom of the page

After you’ve done this, a padlock icon 🔒 will appear next to your username on your profile. Anyone who clicks follow will send a follow request that you have to approve before the follow is activated.

If you change your mind about using follow requests, do the same thing again but tick the box instead of unticking it.

Don’t reject followers just because they don’t have a picture

Don’t screen followers out just because they have blank profile pictures. Many blind users don’t use profile pictures, but they will have text in their profile. The best way to screen potential followers is to read what they have written about themselves and what they have posted.

How do I stop non-followers seeing my posts?

You can set your posts to the Followers-only visibility setting, either manually or by default. When this is combined with the follow requests system, it means only people you choose can see your posts.

↩ Back to the front page

Blocking and muting on Mastodon

It is totally fine to block or mute people on Mastodon and the Fediverse. It is not considered rude or unusual to do so. Use it as freely as you want!

To block or mute someone on Mastodon:

  1. Either click ⋯ on one of their posts, or go to their profile and click the ⋯ or︙ button at the top
  2. Select Mute, Block or Block domain, depending on what you want
  3. If you change your mind, do the same thing again but select Unmute or Unblock

Here’s what these options mean:

  • Mutes are the softest option. When you mute someone you will no longer see their posts and you won’t see posts that mention them. You can also optionally mute notifications from them. People who are muted will not know they are muted, and they will still be able to follow you, see your posts and interact.
  • Blocks are the harder option. When you block someone, it does everything a mute does but also prevents them following you and hides your posts from them while they are logged in.
  • Domain blocks are the most extreme option, and they will block not only that account but all accounts using the same server, and remove any follows from that server. You probably don’t need to do this. The only times this is advisable is if a server is full of nasty people and the server administrator is refusing to do anything about it, or if the server is actually owned by the person you want to block.

⚠️ Important: If you are posting public posts they will still be visible to the blocked person when they log out, because public posts are visible to everyone on the internet. To restrict the audience for a post, use followers-only or mentions visibilities.

How do I keep track of who I’ve muted and blocked?

To view lists of all of your blocks and mutes:

  1. Log in through your server’s website
  2. Go to your profile page and click ︙
  3. Select Muted Users, Blocked Users or Blocked Domains
  4. If you want to remove a mute or block, click the icon next to a name on the list

How do I do a temporary mute?

To have a temporary mute on Mastodon, log in through your server’s website and it will offer you the option of setting a duration when you’re confirming the mute. Set the duration to however long you want the mute to last.

How do I mute just someone’s boosts?

On Mastodon, if you follow someone and you want to see their posts but not their boosts, you can hide just their boosts without blocking or muting them. This doesn’t affect their normal posts, and they have no way of knowing you’re doing it.

  1. Open your Mastodon app or log in through your server’s website
  2. Go to the profile of the person whose boosts you want to hide
  3. Click on the ︙or ⋯ button at the top and select Hide boosts from… (or Hide reblogs on some apps)
  4. If you change your mind, go back to their profile and select Show boosts from… (or Show reblogs)

This only works on accounts you follow.

What happens to DMs sent by someone I’ve muted or blocked?

If you mute or block someone, you won’t see any DMs from them by default. However if you decide to browse their profile you will see any DMs sent to you in their profile timeline.

If you remove a mute or block, DMs will start arriving as normal, but any DMs sent during the mute or block will only be visible by going to their profile.

How do I block DMs from people I don’t follow?

  1. Log onto your server’s website or web app
  2. Click ⚙️ Preferences
  3. Click Notifications (on the mobile website click ☰ and then Notifications)
  4. Tick the box marked “Block direct messages from people you don’t follow”
  5. Click the Save Changes button

If you change your mind, repeat these steps but untick the same box.

Also, if you are blocking DMs from strangers, you might want to mention this on your profile description to avoid any misunderstandings. (This avoids situations where people are trying to contact you for legitimate reasons but think you’re ignoring them.)

Another thing to bear in mind is it will also block private replies in threads from people you don’t follow, as these are technically the same as DMs on Mastodon.

↩ Back to the front page

How do I contact the people who run my server? How do I find out what my server’s rules are?

If you have any problems with the server which can’t be addressed through the reporting system, you can email the administrator (or “admin”) of your server directly.

On Mastodon, you can find the public email address of your server admin on the server’s About page. The same page also lists the server’s rules. To find it, go to your server’s website and click on “Learn More”. You don’t need to be logged in. The email address will be listed in the top half of the About page, just above the list of rules. It is worth reading the rule list as it varies from server to server, and it is usually written in plain language that is easy to understand.

↩ Back to the front page

Reporting problematic content to moderators on the Fediverse

Reporting anti-social accounts is a good idea as it’s the main way server administrators find out about nasty behavour. Once admins are made aware of a problem, they can take action using special blocking tools that are not available to ordinary users.

How do I report posts or accounts on Mastodon?

  • To report a post click ⋯ on the bottom of the post and select Report.
  • To report an account, go to its profile and click ︙ or ⋯, then select Report.

Remember to include examples!

Whatever you’re reporting, it’s really important to include examples of what the account has done wrong. Simply reporting the account with no examples creates a lot of work for the moderators, and it may make it impossible for them to moderate effectively.

On Mastodon, the reporting wizard includes options to select posts from that account, and if you’re reporting via a post then that post will be automatically selected as an example to include on the report.

If possible, tell the account’s own server too

Mastodon reporting forms include the option to also send an anonymous report to the server of the account that wrote the post. This is usually a good idea, because only a user’s home server has the power to suspend or delete their account. Other servers can block accounts, but in the worst cases it may be better that a nasty account is deleted at source.

However, there is a caveat to this: if the problematic user’s entire server is also problematic, it may be best not to include them in the report. Such servers tend to lash out when people report their behaviour. Your own server admin will be able to block problematic servers completely, which is usually the best way of dealing with such servers.

What do I do about accounts that just boost nasty stuff?

If there’s an account that boosts lots of problematic posts, go to their profile and report them from there (by clicking ︙ or ⋯). If you do this though, remember to mention in the comments section of the report the boosts that are problematic and why, so that the moderator can locate them more easily.

What exactly ARE the rules on the Fediverse?

Each server is totally independent and sets its own rules for acceptable behaviour. If you go to a server’s about page you should see a copy of its rules. If possible, it’s worth reading this before you sign up on a server, as it can tell you a lot about their approach to moderation.

If there’s something bad happening and it isn’t covered by the rules, report it. There will often be bad situations that could not have been anticipated by the admin when writing the rules, and they depend on user reports to find out about them.

If you’re in any doubt about what is acceptable, ask your server’s admin for advice. If there’s something wrong with their approach or attitude, you might want to consider transferring your account to another server.

↩ Back to the front page

Do I need to use my real name or real photo?

No.

You don’t need to reveal any kind of personal information about yourself on the Fediverse. Use any name you want, and any picture (or no picture at all).

The only information you need to give when signing up on a Fediverse server is an email address, and you can use an email alias if you want to keep it secret. The only other data a Fedi server might see is your computer’s or phone’s IP address, but this is hidden if you’re using a VPN or Tor.

Revealing personal information on the internet is a bad idea in general, as it makes unwanted tracking and identity theft much more likely.

What if I want to impersonate someone else?

Whatever name you choose to use, don’t impersonate other people, it’s not very nice and would break the rules on many servers, possibly getting you banned. Impersonation may also be illegal in some countries.

Can I leave the profile picture blank?

Yes, if you want. A lot of blind people on the Fediverse don’t use profile pictures, and there is no obligation to have a picture.

↩ Back to the front page

How to delete your Mastodon account

You can delete your Mastodon account at any time. There’s no cool-off period, the deletion happens as soon as you confirm it.

  1. Log in through your server’s website
  2. Go to Preferences > Account > Delete account
  3. Click Proceed here and follow the instructions. It will ask you for your password to confirm the deletion.

⚠️ After you confirm deletion, it will delete your account straight away and it cannot be restored. Be really sure you want to do this. Once it’s deleted, it is gone forever and no one can bring it back.

After an account is deleted, no one else will be able to use that username on that server, in order to prevent anyone impersonating a deleted user. If you want to sign up for a new account on the same server, you’ll need to think of a new username.

↩ Back to the front page

How to log out of your Mastodon account

On Mastodon, if you’re logged in on your server’s website, you can log out by clicking the ︙ (in desktop mode) or the ☰ (in mobile mode) and selecting Logout at the bottom of the menu.

If you’re logged in on the official apps, you can log out by clicking the ⚙️ settings icon and selecting Sign out at the bottom of the menu.

The third party apps will have various ways of logging out, usually on their settings pages.

IMPORTANT NOTE: You don’t have to log out to use a different account on a different server, you can be logged in on multiple accounts at once. The websites, the official apps and the third party apps all support being logged in on several different accounts at once, as long as the accounts are on separate servers. To log in on another account on the website just go to the other server’s site and log in. To log in on another account on the apps, click and hold your profile picture in the bottom right corner of the screen.

↩ Back to the front page

How do I browse the Local timelines of other servers on Mastodon? Can I follow other servers’ Local timelines from my account?

On Mastodon, you can browse other servers’ Local feeds by going to the server’s website and clicking the “Local” link. You don’t need to log in, anyone can look at the feed because Local feeds only show public posts anyway.

What about following another server’s Local timeline?

Some third party Mastodon apps (Fedilab and Subway Tooter on Android, Ice Cubes on iPhone/iPad) let you follow the Local timelines of other servers. The website interface and the official apps do not have this feature yet.

Many, many people have asked for this feature to be added to the website interface. If you want to vote for this and you are comfortable using Github, click here and give a thumbs up to the first post in this thread ⧉. This will let the developers know that the feature is wanted.

↩ Back to the front page

What are the Local, Federated and Home timelines? How do I stop them scrolling too quickly?

Most Fediverse server types including Mastodon have options to show three different timelines: Home, Local or Federated. They might have slightly different names depending on the server type, but they’re usually something like this.

  • Home is the normal timeline that you see by default. It shows you all the posts from all the people you follow in chronological order. This is what you see when you log in to your account.
  • Local (also known as Community or Live Feed: This Server) shows all the public posts made by all the people on your server. On larger servers this can be a so-called firehose that is too random and unfiltered. However, on smaller servers this can be a really interesting feed to read, especially if the server is well moderated. Many people on small servers discover new accounts to follow through the Local feed.
  • Federated (also known as Live Feed: All) shows all public posts that your server has noticed. Click here for a guide to which posts and accounts your server will notice. On larger servers Federated is an absolute nightmare to comprehend as there are so many posts on so many different topics.

Where can I see trending posts and hashtags?

Trends are in their own section, click here for the guide to trends.

Can I create my own custom timelines on Mastodon?

Yes. The Lists feature lets you make your own themed timelines with whatever accounts you choose.

How do I view different timelines on Mastodon?

By default you will see your Home timeline.

To see other timelines on the Mastodon website or the Mastodon web app, click the 🌎 Live Feeds link at the right of the screen, then select the tab at the top labelled This Server for the Local feed or All for the Federated feed. The Other Servers feed shows the Federated feed minus posts from the Local feed.

On third party Mastodon apps there will be various interfaces and icons for viewing Local and Federated timelines.

On the official Mastodon app, click the magnifying glass and then scroll to the Community tab, which will show you the Local feed. The official Mastodon app doesn’t show the Federated feed at all, but you can see it by using a third party app, the web app or your server’s website instead.

The timelines are scrolling way too quickly, I can’t keep up with them! Help!

If you’re logged in through your Mastodon server’s website, you can optionally use “slow mode” to stop all automatic scrolling on feeds. When slow mode is activated, the feed will only show new posts when you manually click a special link at the top of the feed. To switch it on:

  1. Log in through your server’s website
  2. Go to ⚙️ Preferences
  3. Tick the box marked Slow Mode, then click the button marked Save Changes

To deactivate slow mode, do exactly the same thing but UN-tick the Slow Mode box and click Save Changes.

How do I see another server’s Local timeline?

Click here for more info on how to do this.

↩ Back to the front page

What are toots? What are boosts? What are CWs? What are instances? What is birdsite? What is vanilla Mastodon?

Mastodon and the Fediverse have a number of common terms which you may not have heard of on other social networks. Here’s a guide:

  • Toots are posts, the Mastodon equivalent of tweets. The mascot for Mastodon is a mastodon, an ancient relative of the elephant ⧉, and “toot” is sort of the sound an elephant makes. Programmers sometimes call them statuses.
  • Boosts are shared posts, the Mastodon equivalent of a re-tweet. Programmers sometimes call them re-blogs. If you boost a post, it will appear in the home timelines of your followers.
  • CWs are Content Warnings, used to hide a post underneath a title. There’s detailed info about them here including why they exist and how to use them.
  • Instances are the sites you can sign up on on the Fediverse, also known as “servers”. They were also known as “communities” for a while, and some people call them “nodes”. All of these are just different names for exactly the same thing: the site you signed up on. If someone talks about Fediverse instances, they are talking about Fediverse servers, they are one and the same.
  • “Birdsite” and “Hellsite” are nicknames for Twitter, sometimes indicated by a bird on fire (it’s a comment on how discussions on Twitter very often turn into horrible arguments).
  • Vanilla Mastodon means standard unaltered Mastodon software, which most Mastodon servers use. Some servers use non-standard altered versions of Mastodon, such as Glitch or Hometown, and they work just as well as vanilla but tend to have more features and options.

↩ Back to the front page

Inviting people onto Mastodon and the Fediverse

The easiest way to invite friends, family or colleagues to join you on the Fediverse is to send them a link to JoinMastodon.org ⧉ or Fedi.Garden ⧉ or another Fediverse “on-boarding” website. Once they’ve signed up on a server, they can use their account to sign in on their server’s website or on a comptible app.

Once your friends are on the Fediverse, you can exchange addresses with them and follow each other. You don’t need to be on the same server as them, following and interacting with each other is the same experience even if you’re on different servers.

How do I invite people to join my server? Can I invite people if sign-ups are closed?

If you do want people to sign up on the same server as you, there’s an “invite” feature on Mastodon which lets you invite them directly to your server:

  1. Log in on your server’s website or the web app
  2. Click on ⚙️ Preferences
  3. Click on Invite people at the left of the screen (if you’re on the mobile website click ☰ in the top right and then Invite people)
  4. Choose the settings you want for your invitation link and then click Generate.

Some servers close themselves to new sign-ups if they get too full, but still allow existing members to generate invitations. If your friend is unable to sign up on your server directly due to it closing to new members, they may still be able to sign up if you send them an invitation.

I can’t see any “Invite people” link my server. Why is that?

Server admins can optionally switch off the invitation system. If they do this, the “Invite people” link will disappear.

↩ Back to the front page

Customising your Mastodon interface colours

If you’re using Mastodon through the website, you can choose your interface colours by going to Preferences > Site theme, choose the theme you want and click Save changes. By default Mastodon servers come with a dark theme, light theme and high contrast theme, but some servers have a lot more options. If you want more themes, ask your server administrator about it.

If you’re using Mastodon through the official app, you can choose interface colours by clicking the cog gear icon ⚙️ and select Automatic, Always Dark or Always Light, then click Done. There’s also a toggle switch to activate “True Black”, which gives the dark mode a much darker background colour than usual.

↩ Back to the front page

Favourites vs. Bookmarks in Mastodon

Mastodon has two ways to mark posts: Favourites and Bookmarks. These are similar, but they differ in important ways. Here’s a quick comparison:

  • Favourites can be added by clicking on the star icon ⭐ below a post. Favourites are pretty much the Mastodon equivalent of likes, and usually used to indicate you enjoy or appreciate a post. When you add a favourite, the person who posted it will get a notification, and your profile may be visible on the list of people who favourited it.
  • Bookmarks can be added either by clicking on the bookmark icon 🔖 below a post, or if it isn’t visible click on the ⋯ to open the menu and select Bookmark. Bookmarks are totally private, no one else sees what you bookmark. No one gets any notifications when you add a bookmark.

How do I browse my favourites and bookmarks?

If you’re using Mastodon through your server’s website or the web app, click the Favourites or Bookmarks icons at the right side of the screen.

On third party and official apps, you can usually see your favourites and bookmarks by going to your profile page (click on the icon containing your profile image to see your profile page). Favourites are usually indicated by a star icon, Bookmarks by a bookmark icon.

Can I transfer my bookmarks and favourites if I migrate my account to another server?

You can transfer your bookmarks (see steps 2 and 3 in the account transfer guide), but you can’t transfer your favourites.

↩ Back to the front page

Why can’t I quote other posts in Mastodon?

If you’re used to Twitter, you may be wondering why there’s no equivalent of the “quote tweet” on Mastodon.

This was a deliberate design decision taken many years ago by the makers of Mastodon. Here are the lead developer’s comments on it:


Another feature that has been requested almost since the start, and which I keep rejecting is quoting messages. Coming back to my disclaimer, of course it’s impossible to prevent people from sharing screenshots or linking to public resources, but quoting messages is immediately actionable. It makes it a lot easier for people to immediately engage with the quoted content… and it usually doesn’t lead to anything good. When people use quotes to reply to other people, conversations become performative power plays. “Heed, my followers, how I dunk on this fool!” When you use the reply function, your message is broadcast only to people who happen to follow you both. It means one person’s follower count doesn’t play a massive role in the conversation. A quote, on the other hand, very often invites the followers to join in on the conversation, and whoever has got more of them ends up having the upper hand and massively stressing out the other person.

Cage the Mastodon: An overview of features for dealing with abuse and harassment ⧉

However, comments in 2023 by the same lead developer imply that they are considering introducing some kind of quote post feature, possibly with an opt-in system to prevent quoting without consent.

↩ Back to the front page

How do I pin posts on my Mastodon profile?

Pinned posts are posts that appear at the top of your profile page, above your normal posts. Many people use them as introductions, but they can be used for any purpose, for example artists often use them as mini-portfolios with images, video or audio attached.

To pin a post on Mastodon:

  1. Log in through your server’s website or the Mastodon web app or a third party app (the official app doesn’t support pinning yet)
  2. Go to one of your own posts that you want to pin, click the ⋯ icon on the post and select Pin to profile.
  3. The post will now be pinned to your profile. To unpin it, click ⋯ on the post and select Unpin.

You can pin up to five posts at once on your Mastodon profile, and you can also reply to a pinned post to create a pinned thread. By creating pinned threads, you can extend each pinned post to whatever length you want.

Pinned posts will be the first thing people see when they look at your profile, and for various technical reasons pinned posts will be more widely seen on the Fediverse than normal posts. (For technical people interested in this topic, Mastodon servers which encounter your account for the first time will automatically “backfill” all pinned posts on your profile. The backfilling also applies to the same user’s replies in pinned threads.)

Why would I use pinned posts when I already have a profile description?

Pinned posts let you greatly expand your profile description, allowing not just text but also images, audio and video. For example, artists might pin posts with their works attached as a portfolio. You can also fit a lot more text onto pinned posts, especially if you use your full limit of five pinned posts.

Also, on a technical note, pinned posts prevent your server ever looking blank to anyone. It’s a good idea to have at least one pinned post on your account to prevent it being blank.

How do I reorder pinned posts?

The pinned posts are shown in the order they were pinned, with latest pinning at the top. To put a pinned post at the top, click on the post and then unpin it, then pin it again. You can use this technique to put the pinned posts in the correct order.

(NOTE: If you’re reordering pinned posts, don’t unpin a post without clicking on it first. When you unpin a post, it will disappear from the pinned section and it may be harder to find it again from amongst your ordinary posts. If you click on it first you will be taken to the enlarged view of the post, and it won’t disappear when you unpin.)

↩ Back to the front page

How do I edit posts in Mastodon?

Screenshot of Mastodon web interface with edit button highlighted
Screenshot of Mastodon web interface with Edit button highlighted

Mastodon lets you edit your posts after they have been published. It lets you edit the text itself, add attachments, add text descriptions to the attachments, add polls, or change the post’s language setting. Here’s how it works:

  1. Go to one of your posts that you want to edit
  2. Click the ⋯ icon at the bottom of the post
  3. Select Edit
  4. Make the changes you want
  5. When you’ve finished editing, click Save Changes

This works on your server’s website, the official apps and third party apps. Third party apps may have a slightly different interface depending on which app you use.

(There was a bug in the first version of editing which meant you couldn’t edit image descriptions. However, version 4.1.0 of the Mastodon server software fixed this.)

What’s to stop someone abusing this feature by changing a post’s contents after it’s shared?

There are several features to prevent abuse of editing:

  • When a post is edited, everyone who has shared it will receive a notification in case they want to un-share it.
  • Edited posts are labelled as edited.
  • Clicking on the edited label displays the full contents of all previous versions of that post, so that others can see all the changes that have been made to it.

These measures together reduce the chance of anyone abusing the editing feature.

Can I edit my post’s visibility setting?

No. For technical reasons you cannot change a post’s visibility after it has been published.

If you absolutely have to change the visibility anyway, use the Delete & redraft option instead, which deletes the post and breaks any links etc, but puts a copy of it into the editing box so you don’t have to retype it all.

⚠️ Warning about editing polls

You can edit polls too, but if you edit the options on the poll it will reset the votes to zero, even if people have already voted. This vote reset happens without warning, so be really sure you want to reset the poll before you edit its options!

You can edit the main text of a poll post without problems though, it’s only editing the options that people vote for that causes a reset.

↩ Back to the front page

How do I share posts on Mastodon and the Fediverse?

You can share a post within the Fediverse by selecting the Boost button which is usually spinning arrows, something like this 🔃

You can share posts with people outside the Fediverse by selecting the Share option, which is often shown as an arrow leaving a square.

On Mastodon’s website version, you can also get a direct link to the post by clicking the ⋯ below a post and selecting Copy link to this post. Alternatively, you can get embedding code to put the post on your own blog or website by clicking ⋯ and selecting Embed.

↩ Back to the front page

What are custom emoji? How do I access them? Can I add new ones?

Every Mastodon server (and some other Fedi server types) can add their own custom emoji, which can be used alongside standard emoji. People on other servers can see your server’s custom emoji, but cannot type them. The emoji can be stills, or short animations within certain size limits.

Here’s how to use them:

  • If you’re logged in through your server’s website, you can access the custom emoji through by clicking the emoji picker icon 🙂 in the top right of the post writing window. The picker normally has custom emoji at the top and the standard ones below them.
  • if you’re using apps, the custom and standard emoji are normally in two separate menus. For standard emoji use the emoji button on your phone’s own on-screen keyboard, for custom emoji use the app’s own emoji icon when writing a post.

Server administrators can add any emoji they want. If you have ideas for custom emoji, contact your server’s admin and tell them about it. When admins add an emoji, everyone on their server is able to use it.

Admins can also block offensive custom emoji from other servers, so if you see any offensive emojis let your admin know by reporting that particular post.

↩ Back to the front page

How do I post images, videos or audio in Mastodon? What can I attach to a post? How do I post GIFs?

On Mastodon, you can attach up to four images, or one video file, or one audio file when making a post. Click on the paperclip 📎 or landscape 🌄 icon to attach something to your post.

  • Images can be PNG, JPG or GIF (including animations). The maximum file size is usually 16mb per image.
  • Video clips can be MP4, M4V, MOV or WebM files. The maximum file size is usually 99mb, but there is no limit on running time.
  • Audio clips can be MP3, OGG, WAV, FLAC, OPUS, AAC, M4A or 3GP files. The maximum file size is usually 40mb, but there is no limit on running time. (If you’re uploading OPUS files, you may need to rename them to have a .ogg extension instead of .opus due to a known bug ⧉.)

File size limits may vary on different servers, but these are the documented defaults. Ask your server admin if you have problems with uploads. Note that if your server is unusually busy then file uploads may slow down or stop for a while.

The file size limits quoted above are from the official documentation. However, there’s some indcation in the source code that they’ve been raised in updates, so you may well find you can upload much larger files.

Making your posts accessible for blind or deaf people

Remember to add text descriptions to attached files before posting, so that they can be accessible to people with disabilities. You can do this by clicking Edit on the file before posting, or writing on top of the attachment itself on some apps. For video clips, remember to describe both the audio and video, so that both deaf and blind people are able to find out what’s going on.

How do I post GIFs in Mastodon?

There is no GIF picker built into Mastodon due to the federated nature of the Fediverse and the need to protect privacy. However, there are three methods for adding GIFs to Mastodon posts:

  • If you post a link to GIF it will automatically be embedded when you post it, as if the GIF had been chosen from a picker.
  • If you have the actual GIF file stored on your computer or phone, you can upload it as an image attachment.
  • Some phones or tablets have a GIF picker built into their on-screen keyboard.

How long can the video or audio attachments be?

Any length! There is no time limit on video or audio, there’s only the file size limit. To post a longer file, reduce its quality so that it stays within the size limit.

How do audio files play?

Mastodon’s web interface and most of the apps have a built-in audio player, some of them with visualisers.

How do I set the artwork for audio?

After you’ve attached an audio file, click the Edit button and then choose an image for the artwork. If you don’t set an image, it will use your profile picture as artwork.

The description has disappeared from the audio file!

If you’ve added a text description to an audio file and it vanishes, add it again and it should remain there okay. There seems to be an intermittent bug that sometimes deletes descriptions from audio attachments when you first upload them.

↩ Back to the front page

Who can see my posts and replies in Mastodon? How do I send DMs in Mastodon?

The visibility of a post or reply on Mastodon depends on its visibility setting. These settings decide which other accounts have permission to see that particular post or reply.

On Mastodon there are four types of post visibility. You can set the visibility of a post by clicking the icon that represents it in the row below the message editing window. It’s usually a 🌐, 🔒, 👥 or @ icon, but some apps may use slightly different icons.

Some more details about each setting:

  • Public – Anyone can see it, even people who aren’t on the Fediverse, and the posts will be visible in searches on Mastodon. If you go to a person’s public profile page you will see all their public posts. This is normally indicated by a globe icon 🌎.
  • Unlisted – Anyone can see it, but it won’t appear in the trending posts list or the Local or Federated timelines, and it won’t show up in search results. This can be useful for replying in threads, so that you’re not filling people’s timelines unnecessarily. Normally indicated by an open lock icon.
  • Followers-only – Only your followers can see these, normally indicated by a lock 🔒 or people 👥 icon. If you use this setting, it’s a good idea to switch on follower requests, otherwise anyone could follow you to see your followers-only posts.
  • Mentioned – Only people you @ within the message can see the post, normally indicated by an @ symbol. Be really careful who you @ because they will see the post.

Sending DMs in Mastodon

You can send people messages by setting a post’s visibility to @ Mentioned, then @ the people you want to receive the DM. If you use your server’s website or the web app, there’s a Private Mentions option in the menu which lets you see all your mentioned posts in a separate inbox.

⚠️ If you @ someone in a DM, they will be able to see it

In all modes including DMs, if you @ someone in a post, they will see that post! Be really careful who you @ in a post because it’s the same thing as sending them a message.

If you absolutely have to mention an account in a DM but don’t want them to see it, try replacing the @ symbols with the word “AT” instead. This will break the address, and prevent the account holder seeing the mention.

I can’t see Unlisted as an option on my app?

Unlisted is available as a visibility option on almost all versions of Mastodon including the website, the web app and the third party apps. However, for some strange reason it is not included on the official apps.

If you want the official apps to support Unlisted and you’re comfortable using Github, you can let the developers know you want it added on the iOS version ⧉ and the Android version ⧉.

Setting your default post visibility

To set the default visibility on new posts:

  1. Log onto your server’s website or the web app
  2. Click on ⚙️ Preferences (or ⚙️ on mobile web) at the right of the screen
  3. Click on Other at the left of the screen (or ☰ and then Other on mobile web)
  4. In the Posting Privacy dropdown menu, choose the default visibility you want
  5. Click the Save changes button in the top right

NOTE: This is only a default setting. You can always set it to a different visibility for individual posts or replies by clicking their visibility icon when you’re writing them.

Is it possible to edit post visibility after it is published?

You cannot edit the visibility of a post or reply after you’ve published it, so make sure you choose the correct visibility when writing it.

If you absolutely have to change the visibility, your only option is to delete the post and start again, which is most easily done by clicking ⋯ below the post and then Delete & re-draft. If you use this option, the original post will cease to exist, its boosts and bookmarks will disappear, links to it will break and its replies will be orphaned.

Who can see my boosts?

When you boost a post, it will immediately appear in the home timelines of all your followers. The original author of the post will also get a notification to say that you boosted their post.

When do replies appear in the Home timeline?

Replies will appear in your Home timeline if any one of these are true:

  • The reply mentions you
  • You wrote the reply
  • The reply is by someone you follow AND mentions someone else you follow
  • Someone you follow is replying to themselves to create a thread
  • Someone you’re following has boosted the reply

When do Unlisted posts and replies appear in the Home timeline?

In Home timelines, Unlisted posts and replies will appear exactly like public posts and replies. Unlisted posts will only be hidden in the Federated and Local timelines, in search results and in the trending posts list.

What about visibility in searches? How do I set the searchability of posts?

Posts and replies will only show up in search results if they have a Public visibility setting. If you want a post or reply to be searchable, you need to set its visibility to Public.

You also need to decide if you want your public posts and replies to be searchable by full text or just by hashtags. By default it’s just hashtags, but you can also allow the entire contents to be searched by opting into the full text search system.

What about Local-only visibility? How do I make a post only visible to people on my server?

Servers running the standard version of Mastodon do not have a Local-only visibility setting. However, servers running forks of Mastodon such as Hometown Mastodon ⧉ or Glitch Mastodon ⧉ may include a fifth visibility setting called “Local” or “Local only”.

Posts or replies using the Local visibility setting can only be seen by people whose accounts are on the same server.

If I’m replying to someone else’s post, do I have to use the same visibility setting on my reply? How do I send a private reply?

You can adjust your reply to have any visibility setting you want, regardless of the original post’s setting. Bear in mind though that some settings may exclude the author of the original post from seeing your reply.

If you want to send a post’s author a private reply, use the @ Mentioned visibility and make sure you @ them in the reply.

What about federation? How widely can my posts be seen by people on other servers?

Have a look at the guide to which posts can be seen from servers.

↩ Back to the front page

Is there a built-in language translation system on Mastodon?

Yes, it is now available to all Mastodon servers. If your server is running the service, you will see a “Translate” link underneath a post in a different language. If you don’t see these links, ask your server admin about it.

The feature relies on knowing which language you speak, so make sure your account’s language preferences are set correctly, as this will allow the system to automatically suggest translations for you. If you have the incorrect language set on a post, it may confuse the translation system.

This feature is currently only on the website interface and also on the excellent third party app Fedilab ⧉.

The built-in translation uses open source translation provider LibreTranslate ⧉.

↩ Back to the front page

Setting your language preferences on Mastodon, filtering out posts in other languages, filtering search results by language

There are lots of language options on Mastodon to help you understand other people, and help other people understand you. At the time of writing there are 95 different languages and dialects to choose from.

Interface language

The interface language is the language used on menus, buttons, labels, forms etc when you are logged in. To choose your Mastodon interface language:

  1. Log in through your server’s website or the web app
  2. Click ⚙️ Preferences
  3. Select the language you want from the dropdown menu marked Interface language
  4. Click the Save changes button

Filtering timelines by language

You can filter Mastodon timelines by language:

  1. Log in through your server’s website or the web app
  2. Click ⚙️ Preferences
  3. Click the link marked Other on the left of the page (on the mobile website click ☰ and then Other)
  4. Scroll down to the section marked Filter languages
  5. Tick the boxes for languages you want to see
  6. Click the Save changes button
  7. To switch the language filter off (so that you see all languages), make sure all the boxes are UN-ticked and click the Save changes button

When the language filter is on, posts in other languages will no longer appear in your timelines. However, if you follow someone this will override the language filter and show you all their posts regardless of language used.

Posting language

It’s important to set your posting language, because it means people using language filters to show your language will see your posts. Setting this also allows other people to automatically translate your posts using Mastodon’s built-in translation system.

To set which language you post in:

  1. Log in through your server’s website
  2. Go to Preferences > Other > Posting language
  3. Choose which language you use most often and click Save changes

If you post in multiple languages, you can change which language you’re using each time you’re writing a post:

  1. Write the post but don’t publish it yet
  2. Select the language you are writing from the language button. The language button is a two letter country code in the bottom row of icons, for example EN for English.

By default the button will be your selected posting language, unless you are replying to a post marked in another language in which case it will be set to that language.

The language button should remember your most recently chosen languages at the top of the menu.

Filtering search results by language

You can filter your search results on Mastodon to only show posts in particular languages by including the search operator “language:(LANGUAGE CODE)” using language codes from this list. For example to only show posts in French include the term language:fr in searches.

See the guide to searching Mastodon for more details on using special search operators.

Wait! I’m still seeing languages I don’t understand in my Home timeline! Why aren’t the filters hiding them?

Unfortunately if you follow an account or a hashtag, this overrides the language filters, so by default you’ll see all posts in all languages on the Home timeline.

There is a workaround for filtering the language of accounts you’re following, but it’s slightly more fiddly than general language filters:

  1. Log in through your server’s website or the web app.
  2. Go to the profile page of the account you want to filter by language.
  3. Click ︙ and select Change subscribed languages
  4. Tick the boxes for the languages you want to see
  5. Click the Save Changes button

You have to do this for any account you’re following where you want to restrict which languages it shows. For example, if ten people you follow are posting in languages you don’t want to see you’ll have to do this for each of those ten accounts.

Obviously this isn’t as easy as just setting a single language filter, and if you’re following lots of people who post in many languages it can take a while to set preferences for each of them. Also, this option isn’t even available for followed hashtags. This situation isn’t satisfactory, and you may want to give feedback to the developers about this at the links below.

If you’re comfortable using Github, you can vote for language filters to apply to the Home timeline by giving a thumbs up to the first post in this issue ⧉. You can also vote for language filters to apply to hashtags you follow ⧉.

Contributing translations for the Mastodon user interface

If you want to add or correct translations on Mastodon’s interface, click here to go to the Mastodon translation website ⧉.

↩ Back to the front page

Where are the trending posts and hashtags on Mastodon?

Mastodon has a section called Explore which shows trending posts, trending hashtags and trending links. Here’s how to see it:

  • On your server’s website or the Mastodon web app, click on the # Explore link or the # icon on the right of the screen.
  • On the official Mastodon apps click on the magnifying glass at the bottom of the screen without entering anything into the search box, this will automatically make the trends appear. There’s also a Community tab in the same section which is your server’s Local timeline.
  • Third party apps display trends in various different ways using their own interfaces. However, they usually use the word “Trending” in some way. Often you can find the trends link in the main settings menu, but this will vary from app to app.

What makes a post trend on Mastodon?

Posts trend if they are new and have many recent boosts. Only one post per account can trend at a time, to prevent popular accounts dominating the trending section.

What makes a hashtag trend on Mastodon?

Tags trend if many people have used them recently.

What if I see an offensive post, hashtag or link trending?

Hopefully this won’t happen, as your server admin can optionally screen posts, tags and links before they are allowed to trend.

If you see something offensive trending, contact your server admin and ask them if they are screening trends.

I am a server admin, how do I screen trending posts/tags/links?

Log in through the website, click ⚙️ Preferences, then click Trends.

If you’re on the mobile site you will need to click the ⚙️ icon on right of screen, then ☰ in top right, then Trending Posts, Trending Hashtags or Trending Links.

Note that for links you can moderate both individual links and the sites they come from.

What is the News section in Explore?

News just shows the most shared links on posts visible to your server, whether they’re from news sources or any website. Often this will be news items (hence the name), but not always.

Can any link trend on the News section? What do I do if I see dubious news sources trending?

Your server’s admin can optionally choose to moderate which sites’ links end up in the News section. By setting a trusted set of sources, your admin can prevent the trending news section being hijacked by people spreading less trustworthy sources.

If you see a news source trending which shouldn’t be, contact your admin and they will be able to block it from appearing on the trends.

What about the People section in Explore? Are these trending people?

No. They’re just automated suggestions for accounts you might want to follow. It’s a bit unclear why these suggestions are listed next to the trends, to be honest!

Can I view trends on other servers?

Yes. Most servers have a link to their # Explore section on their websites, and you usually don’t need to be logged in to browse this. The trending posts and tags on different servers will be slightly different as they have different views of the Fediverse. You do need to be logged in if you want to interact with the posts, however.

↩ Back to the front page

How to be notified when your favourite accounts post on Mastodon

When you follow someone you’ll see all their posts in your home timeline in chronological order. No posts will be hidden, but when you follow a lot of people it can be easy to miss some of the posts because there may be just so many of them.

On Mastodon, if there are particular accounts where you want to make sure you see their posts, you can set these accounts to also notify you when they post. They will still be in your timeline as normal, but you’ll also get an an alert in your Notifications section.

Here’s how to do it:

  1. Log in through your server’s website or through the web app or certain third party apps
  2. Go to the profile of the person you want to be notified about
  3. Click the bell icon 🔔 next to their follow/unfollow button.

Note that this only works for people you follow. Also, if you want to stop notifications just click the same bell icon again.

Can I do this through apps too?

Yes and no. The official apps don’t have notification bells yet, but some third party ones do such as Ice Cubes and Toot! on iPhone/iPad, or Tusky and Fedilab for Android. The ones that support the notification bell may sometimes have a slightly different interface, for example the Toot! app has a “Notify” button instead of a bell icon.

↩ Back to the front page

How do I get my account and posts discovered on Mastodon and the Fediverse?

If you want your account to be discovered by more people with similar interests, here are some tips:

  • Write something about yourself on your profile. It doesn’t have to be personal info, but it should let people know you’re a human being and give them some idea of what you’re interested in.
  • If you want the entire text of your public posts to be completely searchable, even without any hashtags, you can opt into being part of the full text search system
  • If you have a website, include a link to it on your profile and also link to your profile from your website. Remember to have https:// at the beginning so that people can click on it.
  • Also, if you have a website, you might want to verify the website link too, as this will make people know you’re the owner of the site and also make your account appear on discovery services such as StreetPass ⧉.
  • Make sure the first line of your profile text sums you up well, as Fediverse discovery systems often only show the first line.
  • If you want to, add a profile picture and header image, but these are both optional. Blind people often don’t use images on their profiles, so it is totally normal for a profile to have no images on it.
  • Write a public post saying something about yourself, and include the hashtags #Introduction, #Introductions and #NewHere. Try also searching for these hashtags and replying to other people’s introductions.
  • Pin your introduction post on your profile by clicking the post’s ⋯ icon and selecting Pin on profile. For various technical reasons to do with “backfilling”, pinned posts are much more visible than ordinary posts.
  • Remember to use hashtags in posts that you want to be discovered, as lots of people follow hashtags and they are a very popular discovery method on the Fediverse.
  • Try joining and posting to Fediverse groups, they are seen even more widely than hashtags and can be a good way to connect with others interested in specific topics.
  • Include text descriptions on your images, video or audio. A lot more people will share those posts, as accessibility is valued on the Fediverse.
  • Join in with conversations, follow other people, and eventually you’ll get some follows back. See here for tips on how to find people to follow.
  • After you’ve been on here a while, add yourself to the directory at Trunk ⧉ and the directory at Fediverse.info ⧉. There are instructions on these sites telling you how to add yoursrelf.
  • On Mastodon, log in through your server’s website, go to Edit profile > Suggest account to others, tick the box and click Save changes. This will add you to automated follow suggestions that others may see.

When to post your best content

Don’t post your best content when you have literally zero followers. Fediverse servers “notice” posts from accounts that their members follow. If you post stuff when you have 0 followers then your post won’t be visible to anyone except users on your own server. Even having a handful of followers will make your posts a lot more visible, because all of your followers’ servers will notice what you post.

↩ Back to the front page

What kind of accounts can I follow from Mastodon?

If you’re on Mastodon, you can follow other Mastodon accounts of course, but you can also follow accounts from other types of Fediverse server such as Pixelfed, PeerTube, Friendica, OwnCast, BookWyrm etc.

How do I follow accounts from other kinds of servers?

Exactly like you would follow accounts from Mastodon servers, you just click Follow on their profiles.

The following process on the Fediverse is so seamless that you probably won’t even notice you are following accounts outside Mastodon! No matter what kind of server they are on, all accounts will look like Mastodon accounts when viewed from Mastodon (and vice versa from their point of view). Fediverse servers always display content in their own style, regardless of the style used on the server the content came from.

How do I check what an account looks like on its own server?

If you’re using Masto through the website, you can see what an account really looks like by going to its profile’s original page. This will show you the account’s profile page on its own server.

What if I can’t find an account listed on Mastodon? How do I get it to appear within Mastodon?

No matter what kind of server a Fediverse account is on, you can always follow it on Mastodon by copying and pasting its account address into the search box on Mastodon.

↩ Back to the front page

How do I discover accounts to follow on Mastodon and the Fediverse?

There are lots of ways to discover interesting accounts on topics you are interested in, see below for a complete list.

(If you want to follow people you already know in real life, the most reliable way to do that is to exchange account addresses with them. Click here to go to the account address guide.)

Do a keyword search

You can find a lot of interesting accounts nowadays just by typing keywords into the search box on Mastodon. Once the results come up, choose the Profiles section to only see accounts. (Searching for profiles works a lot better after changes made in the Mastodon 4.2.0 update from September 2023.)

Follow hashtags

Maybe the easiest way to to discover new accounts on particular topics is to follow hashtags. Posts with followed tags will appear in your home timeline automatically as soon as they’re posted, so you don’t have to go looking for them. Click here for more details on how to follow hashtags.

Join Groups

Groups are special kinds of accounts which share posts on particular topics. If you want to post to the group, you just mention the group’s account and your post gets shared with all the group’s followers. Click here for more details about groups and how they work.

Word of mouth

When you follow an account that account will usually share interesting posts by others, and if you like the posts you can follow the authors of those shared posts too. There is no algorithm on Mastodon and the Fediverse, it’s all human beings, and word of mouth is a significant way to discover interesting accounts.

Browse other people’s follow lists

You can usually browse an account’s follows and followers by visiting the account’s original page. (Bear in mind though that some people have their follow lists to private, in which case the lists will be hidden.)

If you browse a profile’s follows and followers without going to the original page, it will just show accounts from your server. That’s why the original page is better as it shows you the complete lists.

Follow FediFollows

I run an account over at @FediFollows@social.growyourown.services ⧉ which publishes themed lists of interesting accounts to follow, with a new topic every day. The accounts are all hand picked and currently active. You can also browse previously suggested accounts organised into categories at fedi.directory ⧉.

Browse directories

Another method is to browse human-run Fediverse directories. They only list a fraction of the users on the Fedi, but they’re a really good way of beginning the process of building up your timeline. The people you follow will then share posts from others, and soon you’ll be discovering even more accounts to follow just by browsing your own timeline.

Here are some good Fediverse directories:

  • Fedi.Directory ⧉ is a human-curated collection of Fediverse accounts that tend to post about specific topics, so it’s a smaller selection but with more guaranteed quality. (By the way, as mentioned above, I’m the one who maintains this directory 🙂)
  • Trunk is a community-run opt-in directory ⧉ of people looking for followers. Users decide which categories they go in, and the listings are moderated by the site’s maintainers.
  • Fediverse.info is a keyword-based opt-in database ⧉ of people looking for followers. Users decide which keywords they have on their profiles.

Follow curators

There are human-run accounts dedicated to sharing interesting posts on specific topics or areas. Following them can offer you lots of suggestions for interesting accounts to follow.

Look at trending posts and hashtags

Mastodon has a built-in feature for seeing which posts and hashtags are trending, this can help you discover interesting accounts and active topics:

  • To access trends on your server’s website, click the # Explore link on the right of the screen. You can also browse Explore on other servers’ websites if you want to, as it doesn’t require logging in.
  • To access trends on the official apps click the magnifying glass and leave the search box blank. There’s no Explore label on the official apps, but it’s the same contents as Explore. This will show you trending posts and hashtags which will help you discover even more interesting people. There’s also an extra tab labelled “Community” which is the same thing as the Local timeline on the web interface.
  • You can also see trending posts and hashtags on third party apps, they will have their own interfaces for seeing them, usually labelled “Trending” or similar.

Trending posts are based on how often they have been recently shared, trending hashtags are based on how often they have been recently used.

Install StreetPass for Mastodon on your web browser

There’s a free open source web browser extension called StreetPass for Mastodon ⧉ which checks if websites you’re browsing have featured their Mastodon address using a verified link. The extension gradually builds up a list of Mastodon accounts you might want to follow, based on which sites you’ve browsed.

Search for flag emoji to find accounts in particular countries

You can also use Mastodon’s search function to search for standard emoji. If you paste or type a particular country’s flag emoji into the search box, it will show you accounts and posts using that flag, which are usually located in the flag’s country.

For example, if you put the Swedish flag 🇸🇪 into the search box, most of the profiles containing that emoji are Swedish.

Hang out on the timelines

Finally, the most traditional approach to discovery is simply to hang out on the timeline, search for particular hashtags, browse the Local or Federated timelines and follow any accounts you find interesting.

↩ Back to the front page

How do I do likes and re-tweets in Mastodon? And what are bookmarks?

  • The Mastodon equivalent of “Likes” are “Favourites”, click the star ⭐ to favourite a post. Favouriting tells the author that you liked their post, but does not affect the post’s visibility at all.
  • The Mastodon equivalent of a “Re-Tweet” is a “Boost” (and some apps call it a “Re-Blog”). To boost a post, click the circular arrows 🔃 underneath it. Boosted posts will appear in the timeline of everyone who follows you, and boosting will also help a post appear on the trending posts chart in the Explore tab. Boosts are the only way to make a post more visible.
  • There’s also a third option called “Bookmarks” which lets you keep a private list of posts you want to read later. Only you can see your bookmarks, the people you bookmark do not know about it. To bookmark a post click ⋯ underneath the post and then “Bookmark” (some interfaces will also show a bookmark logo which you can click instead).

You can browse past Favourites and Bookmarks on your profile page on the official apps, on the icons on the right of the screen on the web, or with other interfaces on third party apps.

You can see all your past Boosts by browsing your profile page, they will be mixed in with your own posts in chronological order.

↩ Back to the front page

How do I search for stuff on Mastodon? How do I use hashtags?

You can search for posts and profiles on Mastodon by typing ordinary words or hashtags or emoji into the search box:

  • To search on the official app, tap the magnifying glass icon at the bottom of the screen, and type in the search box at the top of the screen. The results will appear below it.
  • To search on your server’s website, type into the search box and press enter. The results will appear beside or below the search box, depending on your window size.
  • If you’re using the website through a phone, click on the 🔍 magnifying glass icon at the top.
  • Third party apps will have various interfaces for search, but they’re usually quite obvious, using a magnifying glass icon or the word “search”. (One exception is Toot! which has its search function bizarrely hidden away in the ⋯ menu in the top right corner.)

How do I make my own posts more visible in search results?

If you want your post to be more easily found in searches, opt into full text searches but also include relevant hashtags if you can. Remember to use CamelCase on hashtags that contain multiple words.

Although hashtags are no longer required to appear in search results, hashtags are still important in making posts visible, because many people follow hashtags and many people search for them. Hashtags are really good for actively indicating a topic being discussed, instead of a word just used accidentally or incidentally.

What exactly are hashtags? How do I use them?

Hashtags are words or phrases with a # (hash symbol) at the start, such as #Weather. It’s a good idea to include relevant tags in your posts to make it easier for people to discover them. If a hashtag has multiple words you should write the tag without spaces but with the first letter of each word capitalised, such as #PremierLeagueFootball. Capitalising the first letters of words makes a hashtag easy to read and accessible to blind people using screen reader apps.

You can include as many hashtags as you want, but they must be relevant. If you include irrelevant tags in your posts it is spamming, and your account may be blocked or suspended by admins.

What order are search results shown in?

Chronological, with newest posts at the top.

How do I search just my own posts?

To search just your own posts, include the phrase from:me in your search. If you want to search posts that you’ve interacted with, include the phrase in:library in your serarch.

There are lots more operators like this, scroll further down this page to see them all.

Are there any special operators for filtering searches on Mastodon?

Yes, Mastodon 4.2.0 introduces a number of operators you can use to filter your search results with:

  • has:media – Only shows posts with an attachment (images, audio, video)
  • has:poll – Only shows posts with a poll
  • has:embed – Only shows posts with a link that produces some kind of embedded media (such as a YouTube or PeerTube link)
  • language:fr using language codes – Only shows posts using that language, the example would filter for posts in French. Click here to see a complete list of language codes on Mastodon.
  • is:reply – Only shows posts that are replies
  • is:sensitive – Only shows posts marked as sensitive
  • from:(FEDIVERSE ADDRESS HERE) – Only shows posts by that particular user, for example from:@FediTips@social.growyourown.services
  • from:me – Only shows posts you have made yourself
  • in:all – Searches all posts visible to you
  • in:library – Only shows posts you have interacted with or written yourself
  • before:date, during:date, after:date – Filters for posts before, during or after the selected date. Dates are written in the format YYYY-MM-DD, so for example posts after 1st June 2023 would be after:2023-06-01

Make sure there’s no space between the : and the other words when using these operators. For example, to search for posts with the word “elephant” that are in English, you would search for elephant language:en

Wait, what’s an “operator”?

It’s a special phrase you include in your search that makes the search behave in a special way. The list above describes all of the ones available in Mastodon.

Can I use several operators in the same search?

Yes, just include several operators along with the keyword or hashtag you’re searching for.

Can I use negative operators to exclude certain kinds of posts?

Yes. Just add a – (minus sign) before the term, for example to exclude posts with polls from results you would include the operator -has:poll

How do I opt in to being searched by words as well as hashtags?

Click this link to find out how to opt in to being in full text search results.

Even when I search for stuff, there’s never anything I want!

If you’re on a very new server, it’s possible that it hasn’t noticed much of the Fediverse yet. Try following some groups as they will send all their content to everyone who follows them. Also try asking your server’s admin if they might connect to a relay server, so that the server can see more of the Fediverse.

Wait… I can search for emoji?

Yes! Any emoji can be entered in the search box, and will show posts and profiles containing that emoji in the search results.

It’s a bit more complicated with custom emoji though, you may have to strip away the colons :: around the alt text that appears when you add a custom emoji to a post. The alt text without the colons will show you posts and profiles containing that custom emoji.

My server says search options are unavailable, what’s going on?

Advanced search based on full text keywords and special operators requires the server to be running a special add-on called “Elasticsearch”. Ask your admin about this, it’s possible they haven’t installed it, or they possibly lack the resources to install it as it does cost extra.

However, hashtag searches should work fine on all servers, even the ones without Elasticsearch.

I thought Mastodon only allowed searches with hashtags?

Until very recently, Mastodon searches were entirely based around hashtags. However, since version 4.2.0 (released in September 2023) Mastodon also allows full text searches where you just type what you want and it searches the entire texts of posts for matches.

HOWEVER… for privacy reasons the full text search system is opt-in, so you can only get search results for people who have opted into their posts being included in full text searches.

↩ Back to the front page

How to use and customise profile pages on Mastodon

Screenshot of FediTips profile page on Mastodon including a banner image, profile image, text description, joining date, verified link to a website, links to other accounts, links to other websites.
Screenshot of the FediTips Mastodon profile ⧉ with a verified link to the FediTips website.

On your profile page you can set your display name, picture, banner image and short text (also known as a “biog”) about yourself. You should see an Edit profile or Edit Info button on your profile page which lets you change all these things.

How do I find my profile page?

If you’ve already set a profile image, you should be able to just click on the icon that looks like your profile image to get to your profile. Your profile image is visible on the website and all the apps, usually in one of the corners of the screen.

If you haven’t set a profile image, the icon for your profile will normally be some kind of blank sihouette, depending on what you’re using to access Mastodon.

Fill in your profile’s text

It’s really important to fill in your profile’s text description (also known as a “biog”) if you want people to notice your profile. The first line of the profile text is used in Mastodon’s discovery systems, so it’s a good idea to have this sum up what your account is about.

Upload a profile picture and banner

You can upload or change the profile image and banner for your account on the Edit profile page. However, images aren’t as important as the text, and many blind people do not use profile images at all.

The images can be JPG, PNG or GIF files up to 2 megabytes in size. Pictures will be downscaled to 400×400 pixels, banners will be downscaled to 1500×500 pixels. GIFs and PNGs can be animated, though some people’s settings may prevent the animation playing when they look at your profile.

⚠️ WARNING: Do not use rapidly flashing animations on your profile images. These can be extremely dangerous to people with certain neurological conditions.

Fill in your Mastodon profile’s Extra Fields

On Mastodon, there’s also a special feature called Extra fields which creates a special section of your profile page with clearly labelled website links or any other info you want to highlight about yourself. (Extra Fields were previously known as “Metadata”.)

For example, you could have a label saying “My website” in one box and “https://example.com” in the other box next to this label. Or “My other accounts” and links to your other account addresses on the Fediverse. Or you could have a label “Favourite pizza” next to a pineapple emoji. It’s totally up to you how you use this feature.

If you add a website link in your extra fields, it’s important to include https:// at the beginning of the address so that it is clickable, and if it’s your website you can optionally verify it to prove you are the owner of the site.

Extra fields appear as prominent boxes on the website version of Mastodon, and on the official apps it appears in the About section of your profile. Third party apps will show these in various ways, usually boxes on your profile page.

To edit your profile’s Extra Fields feature through the website:

  1. Log in through your server’s website
  2. Click on your profile image to go to your profile page
  3. Click Edit profile, then go to the Extra Fields section of the page
  4. Fill in up to four labels and content. The labels can be text or emoji, the content can be links, text or emoji. If you do put links in, remember to put the https:// at the start so that they are clickable.
  5. Click Save changes

To edit Extra Fields through the official apps:

  1. Click on your profile image to go to your profile page
  2. Click Edit Profile or Edit Info
  3. Scroll down to the About section and click on the + button or Add Row to add a field
  4. You can edit an existing field by tapping on its title or contents to edit them
  5. When you’ve finished, click the Done button at the top

Third party apps may also support editing Extra Fields, and will have various interfaces for doing so.

Verifying your account

Verification on Mastodon happens mainly by adding a special link to your website, click here for more info about how it works.

How to add video, audio, images and even more text to your profile

If you want to greatly expand the introductory material on your profile page, try creating a post with the extra material and pin it to your profile. Pinned posts will always appear at the top of the profile for everyone who browses it, and you can pin up to five posts on a single profile.

Pinned posts are particularly useful if you want to let people know about images, video or audio you have created, as media can be attached to posts.

If you do create an introductory post about yourself you might want to include the hashtag #Introduction, as this is the most widely used tag for new people introducing themselves.

↩ Back to the front page

How do I verify my account on Mastodon and the Fediverse?

Screenshot of the Mastodon profile of the Texas Observer featuring verified official website links in green.
Example of a Mastodon profile with a verified official website link and also running on its own server with its own domain name

If you have an official website, the most straightforward way to verify your identity on Mastodon is to link to your Mastodon profile from that official website. If you include a special piece of HTML code in this link, it will make your website address turn green on your Mastdon profile and people will instantly know that you are the owner of (or professionally connected to) that website. If people already trust your website to be official, then by extension they can trust your account to be who it says it is.

Alternatively, if you’re really keen, you can also create an official Fediverse server based on the web address of your official website. This is, for example, how the European Union has verified all its official accounts on the Fediverse.

How to make a link on your Mastodon profile page turn green

On Mastodon, you can create a special verified website link on your profile which turns green. This means anyone browsing your profile will immediately know you’re verified as the owner of the website:

  1. Log in through your Mastodon server’s website or using the web app
  2. Click on Edit profile
  3. Click on the Verification tab
  4. Copy and paste the HTML code from the verification section on Mastodon into your official website’s front page’s code
  5. On Mastodon, add your website’s address into your Mastodon profile’s Extra fields section, remembering to include https:// at the beginning.
  6. On Mastodon, press the Save changes button in your Mastodon profile settings. It is important that you do this step after you have already inserted the HTML code into your website.

After you’ve done all this in the correct order, you should see a link to your official website on your Mastodon profile, which will turn green with a green tick next to it to verify you are the site’s owner. If you have any problems, see the troubleshooting section below.

This can also be used to verify specific pages on a website, for example if you’re listed as a staff member on an organisation’s website. As long as the creator of the website is willing to add the special verification code, you can verify the link.

Create your own server and have your official Fediverse account there

If you’re really keen, the most watertight way to verify your identity is to make your own Fediverse server as a subdomain of your official website. This is what the European Union did when they made their own Mastodon server ⧉ and their own PeerTube server ⧉. Because the European Union’s official website is well known as being at europa.eu, and their servers are all subdomains of europa.eu, it means all the accounts on their servers can be trusted as being official EU Fediverse accounts. Making your own server on a subdomain is much easier and cheaper than you think.

…but don’t verify by doing any of these!

  • Don’t use “verified” badges next to your name, they don’t mean anything. Because no one owns the Fediverse, there is no central authority to give out “verified” badges the way Twitter etc do. If you do see any Twitter-style verified badges these are just custom emoji and don’t mean anything, it’s just people having fun or messing around.
  • Don’t use centralised “verification” services or sites, even if they seem to be friendly and/or temporary. As the Fediverse has expanded, various brand new websites have sprung up trying to set themselves up as the one and only way to verify identity. It’s rubbish, don’t fall for it. The entire point of being on the Fediverse is to prevent any central authorities taking over, and there are already many tried and trusted ways to verify your identity on the Fediverse without using centralised services.

My website address won’t turn green! How do I make it happen?

Don’t panic, there are things you can do:

  • Make sure that all the links to your Mastodon account on your website include rel=”me” in their link code. If there’s one without rel=”me”, for example in a dropdown menu, the verification process may fail.
  • Bear in mind there may be some delay before your website address turns green on your profile, don’t worry if it doesn’t happen straight away.
  • The website address can be case sensitive, so try typing it entirely in lower case.
  • The website address has to have https:// at the beginning (which also makes it clickable)
  • Make sure the HTML code of the a href contains only rel=”me”, the link and no other attributes such as styles.
  • Make sure that you haven’t accidentally used http:// instead of https://
  • Try using this debugging tool ⧉ to check why the link doesn’t turn green

Also, note that each server on the Fedi verfies addresses independently and at their own pace. It is possible that people on other servers may see your address turn green before you do.

If your website link still won’t turn green, try verifying through the header instead

If you can’t get the normal link code to work for verification, you can instead insert this code into your site’s front page’s header:

<link href="https://yourserver/@yourusername" rel="me">

Substitute your profile page’s URL for the example in the code, but leave it otherwise intact.

↩ Back to the front page

Can I use my account to log in on other servers?

Fediverse accounts only let you log in on one server, because all the servers are independent. The server you joined is your gateway into the wider network, because all the different servers talk to each other to form a single network, despite being separately owned.

If that seems confusing, think of it this way: you can’t sign in on Yahoo Mail with a Gmail account, but you can still send emails between Yahoo Mail and Gmail accounts. The reason this works is because the different email providers talk to each other, despite being separate companies.

But I thought Pixelfed lets people log in with their Mastodon accounts?

Not quite. They have a system that lets you create a new Pixelfed account and automatically copy over settings from your Mastodon account, but you still end up with two separate accounts at the end of it (the original Mastodon one and the new Pixelfed one).

What if I want to use features that are only available on a different kind of server? For example tracking my reading on BookWyrm?

If you just want to follow people from other types of server, you can do that from your Mastodon account. Go to the profile page of the account you want to follow and click Follow, or if their profile isn’t visible in Mastodon then paste their account addresses into the search box on Mastodon.

If you want to actually use features that aren’t available on Mastodon, such as the book database on BookWyrm, then you’ll need to set up a separate account on a server that has those features. In the example of BookWyrm, you would need to set up an account on a BookWyrm server.

If you do set up separate accounts, it’s a good idea to mention these on your Mastodon profile so people know to follow your other accounts too.

↩ Back to the front page