Adding alternative text to images in a WordPress post

There is an alternative text field attached to images you upload to WordPress. This alt text provides a description of the image to people with visual impairments. We should strive to add descriptive alt text to all the images we upload to posts in WordPress. Missing alt text registers as an accessibility error in the WAVE scanner from WebAIM.

To add alt text to an existing image in WordPress.

  • Go to the Media.
  • Click on the image that you want to add alt text to.
  • Add some descriptive alt text about the image in the alternative text field.
  • Click anywhere and WordPress saves the field.
Opens in new window: An example of adding alt text to an image of an alarm clock in WordPress
Click above to view an example of adding alt text to an image of an alarm clock in WordPres.

To test if your alt text is really attached to the image you can run the post by the WAVE scanner or inspect the image code for an alt attribute. In some cases if the post code has been customized the alt text entered in the Media area might not appear in customized image markup.

Additional videos and resources about adding alternative text to images in a WordPress blog post: