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