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

If you run a Mastodon server, you can easily add a special bit of custom CSS to your server which causes image, video and audio posts without descriptions to have a red border. Here’s how to do it:

  1. Log onto your server’s website with your admin account
  2. Go to ⚙️ Preferences
  3. Go to Administration
  4. Go to Site Settings
  5. Click the Appearance tab at the top
  6. Copy the code from here ⧉ and paste it into the box marked Custom CSS
  7. Click the Save Changes button

This will still allow users to post without descriptions, but the post will have a red border if there’s no alt text.

↩ 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?

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, but if you’re not used to adding text descriptions it can be easy to forget to add them.

However, help is available! There is a bot called PleaseCaption which will automatically send you a DM if you’ve forgotten to include an alt text on an image, video or audio post.

  1. Follow the PleaseCaption bot at @PleaseCaption@botsin.space ⧉
  2. PleaseCaption will automatically follow you back (if you have follow requests switched on confirm the bot’s request to activate the reminders)
  3. If you post an image, video or audio without a description, PleaseCaption will send you a DM about it as a reminder. You can then edit the post to add the description in if you like.

How do I stop the reminders from PleaseCaption?

To stop the reminders:

  1. Unfollow PleaseCaption
  2. Block and then unblock PleaseCaption, this will remove if as a follower but you will still be able to follow it again in future

How do I delete the reminder DMs from PleaseCaption?

Just favourite a reminder and PleaseCaption will automatically delete it.

Does it check if posts I boost have descriptions?

No, not any more. It used to, but ran into technical difficulties with this feature so the developers have switched boost-checking off for the moment.

↩ Back to the front page

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

If you’re posting a video or audio clip, remember to add descriptions of the sounds too, using the same method as adding descriptions for blind people. Video clips often have text descriptions of the visuals for blind people, but many forget to describe audio for deaf people.

If you can’t add a description of the audio for some reason (for example due to a disability), add a tag #Alt4Me when you post the audio. This will let other people know you want help with describing it, and they may reply with a description using the tag #Alt4You.

If you see a file posted without a description of the audio, you can always post a reply describing the audio with the tag #Alt4You.

↩ Back to the front page

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

Blind and partially-sighted people on Mastodon and the Fediverse use special apps called “screen readers” that read text out loud, so they can tell what is on the screen.

There are many things that sighted people can do to make their posts more accessible to people using screen readers:

  • Add text descriptions (“Alt Texts”) describing the visuals to images and videos you’re posting. To do this, 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.
  • If you forget to add a description, you can go back and edit the post to add a description.
  • 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. This also makes the tag easier for sighted people to read!
  • 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 disabled person wants someone to write a description of the image. Reply to the post with the tag #Alt4You and a 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, you can be be pro-active and reply with a description using the tag #Alt4You.
  • Don’t use long strings of emoji, as these sound really annoying when read out loud by screen readers. It’s okay to use emoji, it’s just the huge groups of emoji all bunched together that cause problems.
  • Don’t use deliberately obscure characters for your username, these can sound like gibberish when a screen reader reads them out (click here for an example ⧉). Standard characters work much, much better with screen readers.

How do I remember to add descriptions to my media posts?

There is an automatic reminder service called PleaseCaption which will remind you by DM if you forget to add an alt text description.

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.

How do I fit the image descriptions into my post without breaking the character limit?

As long as you’re adding the description in the image’s own Alt Text section, it will not count towards your main post’s character limit. There is a much larger limit for descriptions, so you shouldn’t run out of room.

↩ 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