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/

On the desktop web client, 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.

FIXME similar functionality is available on the mobile web app and the Mastodon app

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. On the desktop web client:

  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

FIXME is this available on mobile?

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