This is an old revision of the document!


Add Image Alt Text

Alt text helps people who may not be able to see an image for various reasons by providing a textual description which accompanies the image. A significant guide to alt text, why it is important, and how to achieve good alt text is here: https://webaim.org/techniques/alttext/

When writing a post, you can add an image by clicking on the paperclip icon on the bottom menu on the left.

  1. Once your image is uploaded, click on ! No description added over your image.
  2. You will then see a popup allowing you to add a text description of your image. Try to be as clear as possible in your description. It’s okay if it’s short.
  3. Click Apply and that’s it! You can then publish your toot normally.

Screenshot of the Mastodon web client showing Compose box options dialog. The "Show confirmation dialog before sending toots lacking media descriptions" option is checked and highlighted.

  1. On the main page, click App Settings in the menu
  2. Under Compose box, enable Show confirmation dialog before sending toots lacking media descriptions

You can follow @PleaseCaption@botsin.space to remind you to add alt-text in case you forget.