Skip to main content

Add Alt Tags to Images in Your Articles - Knowledgebase / Technical Systems / IT Knowledgebase - OIT Service Center

Add Alt Tags to Images in Your Articles

Authors list

An alt tag is descriptive text that you can add to your images. It helps make your article accessible to people using screen readers and other assistive devices. 


To add an alt tag:

  1. Insert your image into the article as usual (you cannot copy and paste images into articles, always use the image button in the editing toolbar).
  2. Select the image you just inserted.
  3. In the menu that appears, select the Alternate Text button (indicated by "i" icon).
  4. Type your desired alternate text, then click Update.
  5. Finish editing your article as desired and Save.


Alternate text button when editing a knowledge article



Best Practices in Alternate Text for Documentation

  • No need to include "image of", "picture of", "screenshot of", etc.
  • Be descriptive. For example, if you have a screenshot of entering an override code in Banner, the alt text should be something like "entering an override code in Banner" and not just "Banner"
  • Make sure the steps in your documentation don't just refer to the image (e.g. "click the button seen in the image below") but describe the steps fully so someone would not need the image to complete them.
Helpful Unhelpful

36 of 136 people found this page helpful

Send us a note about this article

Contact the OIT Service Center

Phone: 401-863-4357

Email: help@brown.edu

Location: Page Robinson Hall - 69 Brown St., Room 510

See our availability

https://it.brown.edu/get-help

Walk-ins Welcome! Appointments recommended.

For reserved service for a technical consult or a loaner check-out, you can schedule an appointment here.